parse_ini_file

parse_ini_file(string $filename, [bool $process_sections], [int $scanner_mode]): array
```php

`parse_ini_file` carga el archivo `filename` y devuelve las configuraciones que contiene como un array asociativo.

La estructura de los archivos de configuración leídos es similar a la de `php.ini`.

> [!WARNING]
> 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

`filename`  
El nombre del archivo de configuración a analizar. Si se utiliza una ruta relativa, se evalúa relativa a la carpeta actual, luego según el [include_path](#ini.include-path).

`process_sections`  
Al pasar el argumento `process_sections` a `true`, se obtendrá un array multidimensional con los nombres de las secciones. El valor por omisión de este argumento es `false`

`scanner_mode`  
Puede ser `INI_SCANNER_NORMAL` (por omisión) o `INI_SCANNER_RAW`. Si se proporciona `INI_SCANNER_RAW`, entonces los valores en opción 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

La configuración se devuelve en forma de un array asociativo en caso de éxito, y `false` si ocurre un error.

## Ejemplos

Contenido del archivo `sample.ini`

    ; Este es un archivo de configuración
    ; Los comentarios comienzan con ';', como en php.ini

    [first_section]
    one = 1
    five = 5
    animal = BIRD

    [second_section]
    path = "/usr/local/bin"
    URL = "http://www.example.com/~username"

    [third_section]
    phpversion[] = "5.0"
    phpversion[] = "5.1"
    phpversion[] = "5.2"
    phpversion[] = "5.3"

    urls[svn] = "http://svn.php.net"
    urls[git] = "http://git.php.net"

Ejemplo con `parse_ini_file`

Las [constantes](#language.constants) (pero no las "constantes mágicas" como `__FILE__`) también pueden ser utilizadas en el archivo .ini, por lo que si se define una constante antes de ejecutar `parse_ini_file`, será integrada en los resultados. Solo se evalúan los valores de configuración, y el valor debe ser simplemente la constante. Por ejemplo:

Resultado del ejemplo anterior es similar a:

    Array
    (
        [one] => 1
        [five] => 5
        [animal] => Dodo bird
        [path] => /usr/local/bin
        [URL] => http://www.example.com/~username
        [phpversion] => Array
            (
                [0] => 5.0
                [1] => 5.1
                [2] => 5.2
                [3] => 5.3
            )

        [urls] => Array
            (
                [svn] => http://svn.php.net
                [git] => http://git.php.net
            )

    )
    Array
    (
        [first_section] => Array
            (
                [one] => 1
                [five] => 5
                [animal] => Dodo bird
            )

        [second_section] => Array
            (
                [path] => /usr/local/bin
                [URL] => http://www.example.com/~username
            )

        [third_section] => Array
            (
                [phpversion] => Array
                    (
                        [0] => 5.0
                        [1] => 5.1
                        [2] => 5.2
                        [3] => 5.3
                    )
                [urls] => Array
                    (
                        [svn] => http://svn.php.net
                        [git] => http://git.php.net
                    )

    )

`parse_ini_file` para analizar un archivo php.ini

(analizado) magic_quotes_gpc = Yes
(cargado ) magic_quotes_gpc = Yes

; | se utiliza para OR a nivel de bits
three = 2|3

; & se utiliza para AND a nivel de bits
four = 6&5

; ^ se utiliza para XOR a nivel de bits
five = 3^6

; ~ se utiliza para negación a nivel de bits
negative_two = ~1

; () se utiliza para agrupación
seven = (8|7)&(6|5)

; Interpolar la variable de entorno PATH
path = ${PATH}

; Interpolar la opción de configuración 'memory_limit'
configured_memory_limit = ${memory_limit}

quoted = "She said \"Exactly my point\"." ; Resultados en una cadena con marcas de comillas en ella.
hint = "Use \\\" to escape double quote" ; Resultados en: Use \" to escape double quote

save_path = "C:\Temp\"

long_text = "Lorem \"ipsum\"""
 dolor" ; Resultados en: Lorem "ipsum"\n dolor

code = "\${test}"