Zum Hauptinhalt springen

PHP Einstellungen mit .user.ini

Eine .user.ini-Datei ermöglicht es Ihnen, 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

Stellen Sie sicher, dass Sie nur veränderbare Einstellungen konfigurieren und den OPcache löschen, nachdem Sie Anpassungen vorgenommen haben.

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, müssen Sie den PHP-OPcache löschen (/docs/managed-server-services/webserver/PHP/managed-service-php#empty-the-php-opcache). Dazu führen Sie 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üfen Sie die Liste der php.ini-Direktiven, um festzustellen, ob eine Einstellung durch eine .user.ini geändert werden kann.

Migration von .htaccess

Sofern Sie bisher unseren alten PHP-Stack verwendet haben, müssen Sie 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 beachten Sie 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, können Sie 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