(PHP 5 >= 5.3.0, PHP 7)
parse_ini_string — Analiza una cadena de configuración
$ini
[, bool $process_sections
= FALSE
[, int $scanner_mode
= INI_SCANNER_NORMAL
]] ) : array
parse_ini_string() devuelve las configuraciones de la cadena
ini
a una matriz asociativa.
La estructura de la cadena ini es la misma que la de php.ini.
ini
El contenido del archivo ini que va a ser analizado.
process_sections
Al establecer el parámetro process_sections
a TRUE
, se obtiene una matriz multidimesional, con
los nombres de las secciones y las configuraciones incluidas. El valor por defecto
de process_sections
es FALSE
scanner_mode
Puede ser o INI_SCANNER_NORMAL
(por defecto) o
INI_SCANNER_RAW
. Si INI_SCANNER_RAW
es proporcionado, los valores de las opciones no serán analizadas.
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 configuraciones son devueltas como un array asociativo si se tiene éxito,
y FALSE
si falla.
Nota: Hay palabras reservadas que no se deben usar como claves en los ficheros ini. Éstas incluyen: null, yes, no, true, false, on, off, none. Los valores null, off, no y false resultan en "", y los valores on, yes and true resultan en "1", a menos que se utilice el modo
INI_SCANNER_TYPED
. Los caracteres ?{}|&~![()^" no se deben usar en ningún lugar de la clave y tienen un significado especial en el valor.