(PHP 5 >= 5.3.0, PHP 7, PHP 8)
parse_ini_string — Analiza una cadena de configuración
$ini
, bool$process_sections
= false
, int$scanner_mode
= INI_SCANNER_NORMAL): arrayparse_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 valoresnull
,off
,no
yfalse
resultan en""
, y los valoreson
,yes
andtrue
resultan en"1"
, a menos que se utilice el modoINI_SCANNER_TYPED
. Los caracteres?{}|&~![()^"
no se deben usar en ningún lugar de la clave y tienen un significado especial en el valor.