Ubicación en el registro de Windows

En Windows, PHP puede obtener la ubicación del fichero de configuración principal desde el registro mediante el valor IniFilePath.

Las claves de registro exactas que se examinan dependen de la versión de PHP y de si PHP y Windows son de 32 o de 64 bits.

Para un PHP de 32 bits en un SO de 32 bits, o un PHP de 64 bits en un SO de 64 bits, las siguientes claves de registro se examinan en este orden:

• [HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x.y.z]

• [HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x.y]

• [HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x]

• [HKEY_LOCAL_MACHINE\SOFTWARE\PHP]

En estas claves, x, y y z se refieren a las versiones mayor, menor y de lanzamiento de PHP. Si alguna de estas claves contiene un valor IniFilePath, se utiliza la primera encontrada.

Para un PHP de 32 bits en un SO de 64 bits, las siguientes claves de registro se examinan en este orden:

• [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PHP\x.y.z]

• [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PHP\x.y]

• [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PHP\x]

• [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PHP]

Si alguna de estas claves contiene un valor IniFilePath, se utiliza la primera encontrada.

Sintaxis del fichero de configuración

Las variables de entorno pueden ser referenciadas en los valores de configuración de php.ini como se ilustra a continuación. A partir de PHP 8.3.0, un valor de repliegue puede ser especificado, que será utilizado cuando la variable referenciada no esté definida.

; PHP_MEMORY_LIMIT se toma desde el entorno
memory_limit = ${PHP_MEMORY_LIMIT}
; Si PHP_MAX_EXECUTION_TIME no está definido, tomará el valor de repliegue 30.
max_execution_time = ${PHP_MAX_EXECUTION_TIME:-30}

Las directivas php.ini están directamente documentadas, por extensiones, en las páginas respectivas del manual de estas extensiones. La lista de directivas internas está disponible en el anexo. Es probable que no todas las directivas PHP estén documentadas en el manual. Para una lista completa de las directivas disponibles en su versión de PHP, lea los comentarios de su propio fichero php.ini. También se puede encontrar la » última versión del php.ini en Git.

; todo texto en una línea, situado después de un punto y coma ";" sin comillas es ignorado
[php] ; los marcadores de sección (texto entre corchetes) también son ignorados
; Los valores booleanos pueden ser especificados así :
;    true, on, yes
; o false, off, no, none
register_globals = off
track_errors = yes

; se pueden colocar las cadenas de caracteres entre comillas dobles
include_path = ".:/usr/local/lib/php"

; Las barras invertidas se tratan como cualquier carácter
include_path = ".;c:\php\lib"

Es posible referirse a variables .ini desde ficheros .ini. Por ejemplo : open_basedir = ${open_basedir} ":/new/dir".

Leer un directorio

Es posible configurar PHP para leer los ficheros .ini presentes en un directorio después de la lectura de php.ini. Esto se ajusta durante la compilación con el argumento --with-config-file-scan-dir. El directorio a leer puede ser modificado durante la ejecución por la definición de la variable de entorno PHP_INI_SCAN_DIR.

Es posible leer varios directorios separándolos con un separador de ruta específico de la plataforma (; para Windows, NetWare y RISC OS; : para todas las otras plataformas; el valor utilizado por PHP es disponible en la constante PATH_SEPARATOR). Si se proporciona un directorio vacío en PHP_INI_SCAN_DIR, PHP también leerá el directorio proporcionado durante la compilación a través de --with-config-file-scan-dir.

En cada directorio, PHP leerá todos los ficheros que terminen por .ini en orden alfabético. Una lista de los ficheros que han sido cargados y en qué orden está disponible llamando a la función php_ini_scanned_files(), o ejecutando PHP con la opción --ini.

Suponiendo que PHP está configurado con --with-config-file-scan-dir=/etc/php.d,
y que el separador de ruta es :...

$ php
  PHP cargará todos los ficheros presentes en /etc/php.d/*.ini como fichero
  de configuración.

$ PHP_INI_SCAN_DIR=/usr/local/etc/php.d php
  PHP cargará todos los ficheros presentes en /usr/local/etc/php.d/*.ini
  como fichero de configuración.

$ PHP_INI_SCAN_DIR=:/usr/local/etc/php.d php
  PHP cargará todos los ficheros presentes en /etc/php.d/*.ini, luego
  /usr/local/etc/php.d/*.ini como fichero de configuración.

$ PHP_INI_SCAN_DIR=/usr/local/etc/php.d: php
  PHP cargará todos los ficheros presentes en /usr/local/etc/php.d/*.ini, luego en
  /etc/php.d/*.ini como fichero de configuración.