ToWebs

Descripción

array parse_ini_file ( string nombre_archivo [, bool procesar_secciones] )

parse_ini_file() lee el contenido del archivo ini especificado en nombre_archivo, y devuelve los parámetros que incluye en una matriz asociativa. Al definir el último parámetro procesar_secciones como TRUE, recibe una matriz multidimensional, con los nombres de secciones y parámetros incluidos. El valor predeterminado para procesar_secciones es FALSE

Nota: Esta función no tiene relación alguna con el archivo php.ini. Éste ya ha sido procesado al momento de ejecutar su script. Esta función puede ser usada para leer los archivos de configuración de su propia aplicación.

Nota: Si un valor en el archivo ini contiene caracteres no-alfanuméricos, éste necesita ser rodeado por comillas dobles (").

Nota: A partir de PHP 4.2.1, esta función se ve afectada también por safe mode y open_basedir.

Nota: A partir de PHP 5.0, esta función también gestiona nuevas líneas en los valores.

Nota: Existen palabras reservadas que no deben ser usadas como claves en archivos ini. Entre estas se encuentran: null, yes, no, true, y false. Los caracteres |&~![()" no deben ser usados en ninguna parte de la clave, y tienen un significado especial en el valor.

La estructura del archivo ini es similar al de php.ini.

También pueden procesarse Constantes en el archivo ini, de tal modo que si define una constante como un valor ini antes de ejecutar parse_ini_file(), ésta será integrada en los resultados. Solo son evaluados los valores ini. Por ejemplo:

Ejemplo 1. Contenidos de ejemplo.ini

; Este es un archivo de configuracion de ejemplo
; Los comentarios comienzan con ';', como en php.ini

[primera_seccion]
uno = 1
cinco = 5
animal = PAJARO

[segunda_seccion]
ruta = /usr/local/bin
URL = "http://www.example.com/~nombreusuario"

Ejemplo 2. Ejemplo de parse_ini_file()


<?php

define('PAJARO', 'Ave Dodo');

// Procesar sin secciones
$matriz_ini = parse_ini_file("ejemplo.ini");
print_r($matriz_ini);

// Procesar con secciones
$matriz_ini = parse_ini_file("ejemplo.ini", true);
print_r($matriz_ini);

?>

Produciría:

Array
(
    [uno] => 1
    [cinco] => 5
    [animal] => Ave Dodo
    [ruta] => /usr/local/bin
    [URL] => http://www.example.com/~nombreusuario
)
Array
(
    [primera_seccion] => Array
        (
            [uno] => 1
            [cinco] => 5
            [animal] = Ave Dodo
        )

    [segunda_seccion] => Array
        (
            [ruta] => /usr/local/bin
            [URL] => http://www.example.com/~nombreusuario
        )

)

Las claves y los nombres de sección que consisten de números son evaluadas como enteros de PHP, de modo que los números que comienzan con 0 son evaluados como valores octales y los números que comienzan con 0x son evaluados como hexadecimales.