(PHP 5 >= 5.3.0, PHP 7, PHP 8)
parse_ini_string — Analiza una cadena de configuración
$ini_string
, bool $process_sections
= false
, int $scanner_mode
= INI_SCANNER_NORMAL
): array|false
parse_ini_string() devuelve la configuración en la
cadena ini_string
en un array asociativo.
La estructura de la cadena debe ser la misma que la del archivo php.ini.
ini_string
El contenido de tipo ini a analizar.
process_sections
Al activar el argumento process_sections
con true
, se obtendrá un array multidimensional,
con los nombres de secciones y directivas. El valor por
omisión del argumento process_sections
es false
scanner_mode
Puede tomar los valores de las constantes INI_SCANNER_NORMAL
(por omisión) o INI_SCANNER_RAW
. Si
INI_SCANNER_RAW
es utilizado, los valores de las
opciones no serán analizados.
A partir de PHP 5.6.1 también se puede especificar como INI_SCANNER_TYPED
.
En este modo, los tipos boolean, null e integer se preservan siempre que sea posible.
Los valores de string "true"
, "on"
y "yes"
son convertidos a true
. "false"
, "off"
, "no"
y "none"
se consideran como false
. "null"
se convierte a null
en el modo tipificado. También, todos los string numéricos son convertidos al tipo integer fuera es posible.
Las directivas son devueltas en forma de array array
en caso de éxito, y false
en caso de error.
Nota: Existen varias palabras reservadas que no deben ser utilizadas como clave en los archivos .ini. Esto incluye:
null
,yes
,no
,true
,false
,on
,off
,none
. Los valoresnull
,off
,no
yfalse
son devueltos como "" (cadena vacía) y los valoreson
,yes
ytrue
son devueltos como "1" a menos que el modoINI_SCANNER_TYPED
sea utilizado. Los caracteres?{}|&~![()^"
no deben ser utilizados en ninguna parte en las claves, y tienen un significado especial en los valores.