parse_ini_string

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

parse_ini_stringAnaliza una cadena de configuración

Descripción

parse_ini_string(string $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.

Parámetros

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.

Valores devueltos

Las directivas son devueltas en forma de array array en caso de éxito, y false en caso de error.

Notas

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 valores null, off, no y false son devueltos como "" (cadena vacía) y los valores on, yes y true son devueltos como "1" a menos que el modo INI_SCANNER_TYPED sea utilizado. Los caracteres ?{}|&~![()^" no deben ser utilizados en ninguna parte en las claves, y tienen un significado especial en los valores.

Ver también