PHP Einstellungen mit .user.ini

Eine .user.ini-Datei ermöglicht es dir, einfach die PHP-Einstellungen anzupassen. Ab Ubuntu Bionic werden nur noch Einstellungen via .user.ini unterstützt. Alle darin definierten PHP-Einstellungen werden rekursiv auf den Ordner angewendet, in dem die Datei liegt.

warnung

Stelle sicher, dass du nur veränderbare Einstellungen konfigurierst und den OPcache löschen, nachdem du Anpassungen vorgenommen hast.

Beispiel

/home/www-data/example.com/current/.user.ini

register_globals=on
upload_max_filesize="5M"

Einstellungen Anwenden

Um sicherzustellen, dass alle Einstellungen sofort in Kraft treten, musst du den PHP-OPcache löschen (./managed-service-php#empty-the-php-opcache). Dazu führe nine-flush-fpm nach Änderungen an einer .user.ini aus.

Veränderbare Einstellungen

Nur INI-Einstellungen mit den Modi INI_PERDIR, INI_USER und INI_ALL können in einer.user.ini verwendet werden.

Prüfe die Liste der php.ini-Direktiven, um festzustellen, ob eine Einstellung durch eine .user.ini geändert werden kann.

Migration von .htaccess

Sofern du bisher unseren alten PHP-Stack verwendet hast, musst du die PHP-Einstellungen aus der .htaccess in die .user.ini kopieren.

Dazu muss das erste Schlüsselwort (php_value, php_flag) entfernt und die Definition mit [KEY]=[VALUE] eingetragen werden. Bitte beachte auch, dass die PHP-Einstellungen in der .htaccess-Datei mit einer IfModule-Bedingung umgeben sind, da diese sonst nach der Migration zu Fehlern führen.

Betroffene .htaccess Dateien Finden

Um betroffene Dateien zu finden, kannst du folgenden Befehl nutzen:

find /home/www-*/ -type f -name .htaccess -exec grep -nH "php_" {} +

.htaccess

<IfModule php7_module>
  php_value  include_path         ".:/usr/local/lib/php"
  php_flag   display_errors       Off
  php_value  upload_max_filesize  500M
</IfModule>

.user.ini

include_path=".:/usr/local/lib/php"
display_errors=Off
upload_max_filesize=500M