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:
Existen palabras reservadas que no deben ser usadas como claves en
archivos ini. Entre estas se encuentran: null, yes, no, true, y 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
)
) |
|