For someone who's also wondering.
PHP can work even if there is no configuration file(php.ini) loaded,
it will simply applies the default values to directives.
Le fichier de configuration (php.ini) est lu par PHP au démarrage. Si vous avez compilé PHP en module, le fichier n'est lu qu'une seule fois, au lancement du serveur web. Pour les versions CGI et CLI le fichier est lu à chaque invocation.
Le php.ini est cherché dans ces endroits (et dans cet ordre) :
PHPIniDir
d'Apache 2, l'option de la ligne de commande -c
en CGI et en CLI)
php.ini
peut être définis pour différentes versions de PHP.
La racine des clés de registre dépend de l'architecture 32 ou 64 bit de l'OS et de PHP.
Pour un OS et PHP 32 bit ou un OS et PHP 64 bit, utiliser
[HKEY_LOCAL_MACHINE\SOFTWARE\PHP]
pour PHP 32 bit
sur un OS 64 bit, utiliser
[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PHP]
à la place.
Pour une installation avec la même architecture, les clés de registre suivantes sont cherchées dans cet ordre :
[HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x.y.z]
,
[HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x.y]
and
[HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x]
, où
x, y et z signifie les versions majeures, mineures et normales.
Pour une architecture 32 bit de PHP sur un OS 64 bit, les clés de
registre suivantes sont cherchées dans cet ordre :
[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6421Node\PHP\x.y.z]
,
[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6421Node\PHP\x.y]
and
[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6421Node\PHP\x]
, où
x, y et z signifie les versions majeures, mineures et normales.
S'il y a une valeur pour IniFilePath
dans ces clés,
la première trouvée sera utilisée comme endroit où se trouve le fichier
php.ini
(uniquement sous Windows).
[HKEY_LOCAL_MACHINE\SOFTWARE\PHP]
ou
[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PHP]
, valeur de
IniFilePath
(uniquement sous Windows).
--with-config-file-path
lors de la compilation
Si le fichier php-SAPI.ini existe (où SAPI utilise SAPI, donc le nom du fichier est e.g. php-cli.ini ou php-apache.ini), il sera utilisé à la place du php.ini. Le nom SAPI peut être déterminé en utilisant la fonction php_sapi_name().
Note:
Le serveur web Apache change ce dossier en dossier root au démarrage, ce qui fait que PHP essaye de lire php.ini depuis le système de fichiers racine s'il existe.
Les variables d'environnements peuvent être utilisées dans le fichier php.ini comme ci-dessous.
Exemple #1 Les variables d'environnement dans un fichier php.ini
; PHP_MEMORY_LIMIT est repris depuis l'environnement memory_limit = ${PHP_MEMORY_LIMIT}
Les directives php.ini sont directement documentées, par extensions, sur les pages respectives du manuel de ces extensions. La liste des directives internes est disponible en annexe. Il est probable que toutes les directives PHP ne sont pas documentées dans le manuel. Pour une liste complète des directives disponibles dans votre version de PHP, merci de lire les commentaires de votre propre fichier php.ini. Vous pouvez également trouver la » dernière version du php.ini sur Git.
Exemple #2 Extrait du php.ini
; tout texte sur une ligne, situé après un point-virgule ";" est ignoré [php] ; les marqueurs de section (texte entre crochets) sont aussi ignorés ; Les valeurs booléennes peuvent être spécifiées comme ceci : ; true, on, yes ; ou false, off, no, none register_globals = off track_errors = yes ; vous pouvez placer les chaînes de caractères entre guillemets include_path = ".:/usr/local/lib/php" ; Les antislash sont traités comme n'importe quel caractère include_path = ".;c:\php\lib"
Il est possible de se référer à des variables .ini
depuis des fichiers .ini. Par exemple : open_basedir = ${open_basedir}
":/new/dir"
.
Il est possible de configurer PHP pour lire les fichiers .ini présent dans un dossier. après la lecture de php.ini. Cela est réglé lors de la compilation avec l'argument --with-config-file-scan-dir. Le dossier à lire peut être modifié lors de l'exécution par la définition de la variable d'environnement PHP_INI_SCAN_DIR.
Il est possible de lire plusieurs dossiers en les séparant avec un
séparateur de chemin spécifique à la plateforme (;
pour Windows, NetWare
et RISC OS; :
pour toutes les autres plateforme; la valeur utilisée par PHP est
disponible dans la contante PATH_SEPARATOR
).
Si un dossier vide est fourni dans
PHP_INI_SCAN_DIR, PHP
lira également le dossier fournis à la compilation via
--with-config-file-scan-dir.
Dans chaque répertoire, PHP lira tous les fichiers terminant par
.ini
dans l'ordre alphabétique. Une liste des fichiers qui
ont été chargé et dans quel ordre est disponible en appelant la fonction
php_ini_scanned_files(), ou en exécutant PHP avec l'option
--ini.
Assuming PHP is configured with --with-config-file-scan-dir=/etc/php.d, and that the path separator is :... $ php PHP va charger tous les fichiers présent dans /etc/php.d/*.ini comme fichier de configuration. $ PHP_INI_SCAN_DIR=/usr/local/etc/php.d php PHP va charger tous les fichiers présent dans /usr/local/etc/php.d/*.ini comme fichier de configuration. $ PHP_INI_SCAN_DIR=:/usr/local/etc/php.d php PHP va charger tous les fichiers présent dans /etc/php.d/*.ini, puis /usr/local/etc/php.d/*.ini comme fichier de configuration. $ PHP_INI_SCAN_DIR=/usr/local/etc/php.d: php PHP va charger tous les fichiers présent dans /usr/local/etc/php.d/*.ini, puis dans /etc/php.d/*.ini comme fichier de configuration.
For someone who's also wondering.
PHP can work even if there is no configuration file(php.ini) loaded,
it will simply applies the default values to directives.
Notice that `error_reporting` CANNOT be interpolated with an environment variable (e.g. `error_reporting = ${PHP_ERROR_REPORTING}`).
`error_reporting` is treated differently than other directives:
if assigned an environment variable, this will be silently ignored and replaced with value `0` (aka no-reporting).
I couldn't find documentation about it.
Is maybe an info that should be added in https://github.com/php/php-src/blob/8f5156fcba9906664ecd97e4c279ee980e522121/php.ini-production#L451-L500 ?
I am not aware if this specific behavior affects only `error_reporting` or also other directive.
For anyone who wants to ignore any directory entirely
On a linux Redhat distro (this was on EL9):
; if using php-fpm, put this file in place"
/etc/systemd/system/php-fpm.service.d/override.conf
[Service]
Environment="PHP_INI_SCAN_DIR="
; do a systemd config reload:
systemctl daemon-reload
; if you want to make sure php on the cli fails if it's not passing 'PHP_INI_SCAN_DIR= php' (this should also affect both linux normal+system users?) then drop this file in place:
cat /etc/php.d/00-dont-use-phpd.ini
auto_prepend_file=MISSING_ENV__PHP_INI_SCAN_DIR__SEE_ETC_PHPD_00_DONT_USE_PHPD_INI
; don't allow php.d directory to load in files
; you must pass 'PHP_INI_SCAN_DIR= ' before your php command on the cli
; reference:
; https://www.php.net/manual/en/configuration.file.php#configuration.file.scan
in php.ini you can reference to an existing directive or an environment variable using the syntax ${varname}.
Here are some examples.
sys_temp_dir = "${WINDIR}"
--- ${WINDIR} will be replaced by $_ENV['WINDIR'] at runtime
--- you can set environment variables by Apache and use them in php.ini
--- FcgidInitialEnv AUTHOR "WUXIANCHENG"
--- error_log = "${AUTHOR}.log"
error_log = "${sys_temp_dir}"
--- ${sys_temp_dir} will be replace by the value of sys_temp_dir
Also you can use PHP constants in php.ini, but DONT'T wrap them in ${} or "".
error_log = "/data/"PHP_VERSION"/"
--- it works like this php code:
$error_log = "/data/" . PHP_VERSION . "/";