El fichero de configuración
El fichero de configuración (php.ini)
es leído al arrancar PHP. En las versiones en que PHP funciona como módulo de servidor,
esto sucede únicamente cuando se inicia el servidor. En las versiones
CGI y CLI, esto ocurre en
cada ejecución.
El fichero php.ini se busca en las siguientes ubicaciones (en orden):
-
La ubicación específica de módulo SAPI (directiva
PHPIniDir
en Apache 2, opción de línea de comandos -c
en CGI y CLI,
parámetro php_ini
en NSAPI,
variable de entorno PHP_INI_PATH
en THTTPD)
-
La variable de entorno PHPRC. Antes de PHP 5.2.0,
esta ubicación se comprobaba después de la clave de registro mencionada más abajo.
-
A partir de PHP 5.2.0, se puede establecer la ubicación del fichero
php.ini
para diferentes versiones de PHP. Se examinan
en orden las siguientes claves de registro:
[HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x.y.z]
,
[HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x.y]
y
[HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x]
, donde
'x', 'y' y 'z' significan la versión mayor, menor, y de edición de PHP. Si existiera
un valor para IniFilePath
en cualquiera de estas claves, la primera en
ser encontrada se utilizaría como ubicación del fichero php.ini
(solo en Windows).
-
[HKEY_LOCAL_MACHINE\SOFTWARE\PHP]
, valor de
IniFilePath
(solo en Windows).
-
El directorio actual de trabajo (excepto CLI)
-
El directorio del servidor web (para módulos SAPI), o el directorio de PHP
(excepto en Windows)
-
El directorio de Windows (C:\windows
o C:\winnt) (para Windows), o la opción
en tiempo de compilación
--with-config-file-path
.
Si existiera el fichero php-SAPI.ini (donde SAPI es la SAPI en uso,
por ejemplo, php-cli.ini o
php-apache.ini), se usaría éste en lugar de php.ini.
Se puede determinar el nombre de la SAPI usando php_sapi_name().
Nota:
El servidor web Apache cambia el directorio al raíz al arrancar, haciendo
que PHP intente leer php.ini desde el sistema de ficheros raíz si existiera.
Las variables de entorno se pueden usar en php.ini como se muestra abajo.
Ejemplo #1 Variables de entorno de php.ini
; PHP_MEMORY_LIMIT se toma del entorno
memory_limit = ${PHP_MEMORY_LIMIT}
Las directivas de php.ini manejadas por extensiones están documentadas
en la propia página de cada extensión. Hay una lista de
directivas del núcleo disponible en el apéndice. Es posible que no todas
las directivas de PHP estén documentadas en el manual: para consultar una lista completa
de las directivas disponibles en su versión de PHP, por favor, lea los comentarios del
fichero php.ini. Adicionalmente, puede encontrar útil
» el último php.ini
desde Git.
Ejemplo #2 Ejemplo de php.ini
; todo texto en una línea tras un punto y coma sin comillas (;) será ignorado
[php] ; los marcadores de sección (textos entre corchetes) también se ignoran
; Los valores de tipo boolean puede establecerse a:
; true, on, yes
; o false, off, no, none
register_globals = off
track_errors = yes
; se pueden encerrar los strings entre comillas dobles
include_path = ".:/usr/local/lib/php"
; las barras invertidas reciben el mismo tratamiento que el resto de caracteres
include_path = ".;c:\php\lib"
A partir de PHP 5.1.0, es posible hacer referencia a variables .ini ya existentes desde
el propio fichero .ini. Ejemplo: open_basedir = ${open_basedir}
":/new/dir"
.
Directorios de búsqueda
Es posible configurar PHP para que busque ficheros .ini en un directorio
después de leer php.ini. Esto se puede realizar durante la compilación estableciento la
opción --with-config-file-scan-dir. En
PHP 5.2.0 y posteriores, el directorio de búsqueda puede ser sobrescrito durante la ejecución
estableciendo la vairable de entorno PHP_INI_SCAN_DIR.
Es posible buscar en varios directorios separándolos con el
separador de rutas específico de cada plataforma (;
en Windows, NetWare
y RISC OS; :
en las demás plataformas; el valor que PHP
emplea está disponible como la constante PATH_SEPARATOR
).
Si se proporciona a PHP_INI_SCAN_DIR un directorio en blanco, PHP
también buscará en el directorio dado durante la compilación mediante
--with-config-file-scan-dir.
PHP buscará dentro de cada directorio todos los ficheros que finalicen en
.ini
en orden alfabético. Se puede obtener una lista
de los ficheros cargados, y en qué orden, llamando a
php_ini_scanned_files(), o ejecutando PHP con la
opción --ini.