parse_ini_file

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

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.