(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): 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.
iniEl 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,noyfalseresultan en"", y los valoreson,yesandtrueresultan 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.