array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.parse-ini-string.php', 1 => 'parse_ini_string', 2 => 'Analiza una cadena de configuración', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funciones del Sistema de Archivos', ), 'prev' => array ( 0 => 'function.parse-ini-file.php', 1 => 'parse_ini_file', ), 'next' => array ( 0 => 'function.pathinfo.php', 1 => 'pathinfo', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/filesystem/functions/parse-ini-string.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

parse_ini_string

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

parse_ini_string — Analiza 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.

Advertencia

Esta función no debe ser utilizada con entradas no confiables, a menos que scanner_mode sea INI_SCANNER_RAW, ya que la salida analizada podría contener los valores de constantes sensibles, como constantes que contienen una contraseña de base de datos.

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 puede ser especificado como INI_SCANNER_TYPED. En este modo los booleanos, null y enteros son preservados tanto como sea posible. Las cadenas de caracteres "true", "on" y "yes" son convertidas a true. "false", "off", "no" y "none" son considerados como false. "null" es convertido a null en este modo. Además todas las cadenas de caracteres numéricas son convertidas a entero si 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