PHP: Fichiers .user.ini

Où une directive de configuration peut être modifiée

[edit] Last updated: Fri, 25 May 2012

Fichiers .user.ini

Depuis PHP 5.3.0, PHP inclut le support des fichiers INI au style .htaccess sur une base par dossier. Ces fichiers sont analysés uniquement par le SAPI CGI/FastCGI. Cette fonctionnalité rend obsolète l'extension PECL htscanner. Si vous utilisez Apache, l'utilisation des fichiers .htaccess produit le même effet.

En plus du fichier php.ini principal, PHP analyse les fichiers INI contenu dans chaque dossier, en commençant par le dossier depuis lequel le fichier PHP courant est appelé, et parcours les dossiers jusqu'au dossier racine courant (tel que défini par la variable $_SERVER['DOCUMENT_ROOT']). Dans le cas où le fichier PHP est hors de la racine web, seul sont dossier est scanné.

Seuls les configurations INI avec les modes PHP_INI_PERDIR et PHP_INI_USER seront reconnues dans les fichiers INI .user.ini-style.

Deux nouvelles directives INI, user_ini.filename et user_ini.cache_ttl contrôlent l'utilisation des fichiers INI définis par l'utilisateur.

user_ini.filename définit le nom du fichier cherché par PHP dans chaque dossier ; si cette directive est définie à une chaîne vide, PHP n'analysera rien du tout. Par défaut, vaut .user.ini.

user_ini.cache_ttl contrôle la durée entre 2 re-lectures des fichiers INI définis par l'utilisateur. Par défaut, vaut 300 secondes (5 minutes).

Où une directive de configuration peut être modifiée

Le fichier de configuration

[edit] Last updated: Fri, 25 May 2012

add a note User Contributed Notes Fichiers .user.ini

Dolphyn 28-Apr-2012 06: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 07: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 10: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 03: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