Seit PHP 5.3.0 bietet PHP Unterstützung für Konfigurations-INI-Dateien auf Verzeichnisebene an. Diese Dateien werden nur durch die CGI/FastCGI-SAPI verarbeitet. Durch diese Funktionalität wird die htscanner-PECL-Erweiterung obsolet. Falls Sie PHP als Apache-Modul ausführen, können Sie für den selben Effekt .htaccess-Dateien benutzen.

Zusätzlich zur Haupt-php.ini-Datei sucht PHP auch nach INI-Dateien in jedem Verzeichnis, beginnend mit dem Verzeichnis in der die angeforderte PHP-Datei liegt, aufwärts bis hin zum aktuellen "document root" (wie in $_SERVER['DOCUMENT_ROOT'] angezeigt). Falls sich die PHP-Datei außerhalb des "document root" befindet, wird nur das Verzeichnis, in dem sich die Datei befindet, durchsucht.

Nur INI-Einstellungen mit den Modi PHP_INI_PERDIR und PHP_INI_USER werden als .user.ini-INI-Dateien erkannt.

Zwei neue INI-Direktiven, user_ini.filename und user_ini.cache_ttl steuern die Nutzung der Benutzer-INI-Dateien.

user_ini.filename setzt den Namen der Datei, die von PHP in jedem Verzeichnis gesucht wird; falls dies auf eine leere Zeichenkette gesetzt wird, sucht PHP nach keiner Datei. Der Standardwert ist .user.ini.

user_ini.cache_ttl steuert, wie oft die Benutzer-INI-Dateien neu eingelesen werden. Der Standardwert beträgt 300 Sekunden (5 Minuten).

add a note add a note

User Contributed Notes 8 notes

info at vincentraal.nl
7 months ago
Be aware that PECL htscanner doesn't work (yet) on PHP7.0.

'pecl install htscanner' throws an "zend_hash_update’ undeclared'" error.
philsward at gmail dot com
6 years ago
If you have no idea what "PHP_INI_PERDIR" or "PHP_INI_USER" are or how they relate to setting a .user.ini file, take a look at the ini.list page: http://www.php.net/manual/en/ini.list.php

Basically, anything in the "Changeable" column labeled as PHP_INI_SYSTEM can't be set in the .user.ini file (so quit trying).  It can ONLY be set at the main php.ini level.
Anteaus at thenox dot com
4 years ago
"If you are using Apache, use .htaccess files for the same effect."

To clarify, this applies only to Apache module mode. If you put php directives in .htaccess on an Apache CGI/FastCGI server, this will bomb the server out with a 500 error. Thus, you unfortunately cannot create a config which caters for both types of hosting, at least not in any straightforward way.
8 years ago
This article should be made clearer.
".htaccess-style INI files" meant to me that the ini settings had to follow the syntax used in .htaccess, but this is not the case!

You have to use
and not
php_flag register_globals on

Also, the changes can take a while to propagate to all processes if you have a long process time out.
Restarting php-fpm can give you an answer quicker :)
9 months ago
> Thus, you unfortunately cannot create a config which caters for both types of hosting, at least not in any straightforward way.

That's actually not true, as you can easily wrap all PHP things in conditional block in .htaccess using <IfModule>, i.e.

    <IfModule mod_php7.c>
       php_value ....
1 year ago
Just for clarification: The file name is indeed ".user.ini" (with a trailing dot), not "user.ini". This is not a misspelling.

But "php.ini" is without a trailing dot.
amillionlobsters at gmail dot com
1 year ago
Note that, while the documentation's claim that "only settings with the modes PHP_INI_PERDIR and PHP_INI_USER will be recognised" is technically correct, it's ambiguous: settings with the modes PHP_INI_ALL will be recognised, because PHP_INI_ALL = PHP_INI_PERDIR | PHP_INI_USER | PHP_INI_SYSTEM.
3 years ago
One of the most used is to limit the uploading size and memory limit:

upload_max_filesize = 1000M
To Top