# 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`, 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.

### Parámetros

`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.

### Valores devueltos

Las configuraciones son devueltas como un array asociativo si se tiene éxito, y `false` si falla.

### Notas

> 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 valores `null`, `off`, `no` y `false` resultan en `""`, y los valores `on`, `yes` and `true` resultan en `"1"`, a menos que se utilice el modo `INI_SCANNER_TYPED`. Los caracteres `?{}|&~![()^"` no se deben usar en ningún lugar de la clave y tienen un significado especial en el valor.

### Ver también

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