Analiza una cadena de configuración

# parse_ini_string

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

parse_ini_string — Analiza una cadena de configuración

### Descripción

function 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

- parse_ini_file() - Analiza un archivo de configuración

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open