PHP: .user.ini-Dateien

Wo Konfigurationseinstellungen gesetzt werden können

[edit] Last updated: Fri, 18 May 2012

.user.ini-Dateien

Seit PHP 5.3.0 bietet PHP Unterstützung für INI-Dateien im .htaccess-Format auf Verzeichnisebene. Diese Dateien werden nur nur durch die CGI/FastCGI-SAPI verarbeitet. Durch diese Funktionalität wird die htscanner-PECL-Erweiterung obsolet. Falls Sie den Apache benutzen, sollten Sie daher .htaccess-Dateien benutzen.

Zusätzlich zur Haupt-php.ini-Datei sucht PHP auch nach INI-Dateien in Verzeichnissen, die oberhalb des Verzeichnisses der gerade angeforderten PHP-Datei liegen - bis hin zum aktuellen "document root" (wie in $_SERVER['DOCUMENT_ROOT'] konfiguriert). Falls sich die PHP-Datei außerhalb des "document root" befindet, wird nur das Verzeichnis, in dem sich die Datei befindet, gescannt.

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).

Wo Konfigurationseinstellungen gesetzt werden können

Die Konfigurationsdatei

[edit] Last updated: Fri, 18 May 2012

add a note User Contributed Notes .user.ini-Dateien

Dolphyn 28-Apr-2012 08:48


Apparently the .user.ini file cannot be used to add dynamic extensions. For example, "extension=php_pdo_mysql.dll" has no effect in a .user.ini file (as of PHP 5.3.10 using FastCGI on IIS 6).

Dolphyn 27-Apr-2011 09:43


As of PHP 5..3.6, applicable .user.ini files are *not* listed or identified in phpinfo() output.



A .user.ini file can be in effect even when phpinfo() shows "additional .ini files parsed: (none)"

interfaSys 05-Jan-2011 11:12


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

register_globals=on

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 :)

showerheadsuk at hotmail dot com 14-Oct-2010 05:18


Currently .user.ini files aren't read when using php-fpm, instead you can use [HOST] and [PATH] sections in your main php.ini to set per directory and per domain settings: http://us3.php.net/manual/en/ini.sections.php

add a note