Función parse_ini_file() de PHP
Definición y uso
La función parse_ini_file() analiza un archivo de configuración y devuelve los ajustes en forma de array.
Sintaxis
parse_ini_file(file,process_sections)
| Parámetros | Descripción |
|---|---|
| file | Obligatorio. Especifica el archivo ini que se debe verificar. |
| process_sections | Opcional. Si se establece en true, devuelve un array multidimensional que incluye el nombre y la configuración de cada sección del archivo de configuración. El valor predeterminado es false. |
Descripción
La estructura del archivo ini es similar a la de php.ini.
Las constantes también se pueden analizar en el archivo ini, por lo que si se definieron constantes como valores ini antes de ejecutar parse_ini_file(), se integrarán en los resultados. Solo se evalúan los valores de ini.
Los nombres de clave y los nombres de sección compuestos por números se manejan como enteros por PHP, por lo que los números que comienzan con 0 se manejan como octales y los que comienzan con 0x se manejan como hexadecimales.
Avisos y comentarios
Comentarios:Esta función se puede usar para leer el archivo de configuración de su propia aplicación. Esta función no tiene relación con el archivo php.ini, que ya se ha procesado en el momento de ejecutar el script.
Comentarios:Si el valor en el archivo ini contiene cualquier carácter no alfanumérico, debe colocarlo entre comillas dobles (").
Comentarios:Algunos palabras reservadas no pueden ser utilizadas como nombres de clave en archivos ini, incluyendo: null, yes, no, true y false. Los valores null, no y false son equivalentes a "", y los valores yes y true son equivalentes a "1". Los caracteres {}|"~![()" tampoco pueden usarse en ninguna parte del nombre de clave, y estos caracteres tienen un significado especial en los valores de opción.
Comentarios:Desde la versión 5.0 de PHP, esta función también maneja las nuevas líneas dentro de los valores de opción.
Ejemplo
Ejemplo 1
El contenido de "test.ini":
[names] me = Robert you = Peter [urls] first = "http://www.example.com" second = "http://www.codew3c.com"
Código PHP:
<?php
print_r(parse_ini_file("test.ini"));
?>
Salida:
Array ( [me] => Robert [you] => Peter [first] => http://www.example.com [second] => http://www.codew3c.com )
Ejemplo 2
El contenido de "test.ini":
[names] me = Robert you = Peter [urls] first = "http://www.example.com" second = "http://www.codew3c.com"
Código PHP (process_sections Configurado a true):
<?php
print_r(parse_ini_file("test.ini",true));
?>
Salida:
Array ( [names] => Array ( [me] => Robert [you] => Peter ) [urls] => Array ( [first] => http://www.example.com [second] => http://www.codew3c.com ) )
