Funções PHP |
. Glossários Funções PHP - parse_ini_file ( ) |
(PHP 4 , PHP 5)
parse_ini_file -- Interpreta um
arquivo de configuração
array parse_ini_file ( string nomedoarquivo [,
bool processar_secoes])
parse_ini_file() carrega o arquivo INI informado no nomedoarquivo, e retorna as configurações dele em um array associativo. Ao usar processar_secoes como TRUE, você receberá um array multidimensional, com os nomes das seções e os parametros incluidos. O padrão (default) para processar_secoes é FALSE.
Nota: Esta função não tem nada a ver com o arquivo php.ini. Este já é processado na hora que você executa o script. Esta função pode ser usada para ler os arquivos de configuração de sua própria aplicação.
Nota: Se o arquivo INI tem qualquer caracter não alfanumérico, eles precisam estar delimitados por aspas (").
Nota: Desde o PHP 4.2.1, esta função é afetada por safe mode e open_basedir.
Nota: Há palavras reservadas que não podem ser utilizadas como chaves para arquivos INI. Elas incluem: null, yes, no, true, e false.
A estrutura do arquivo ini é similar a do php.ini.
Constantes podem ser interpretadas no arquivo INI se você definir uma constante existente no INI antes de executar parse_ini_file(), sendo parte integrante dos resultados. Somente valores no INI são avaliados. Por exemplo:
Exemplo:
Exemplo 1. Conteúdo de exemplo.ini
; Este é um arquivo de configuração de exemplo
; Comentário começam com ';', como no php.ini
[primeira_secao]
um = 1
cinco = 5
animal = PASSARO
[segunda_secao]
path = /usr/local/bin
URL = "http://www.example.com/~username"
Exemplo 2. exemplo de parse_ini_file()
<?php
define ('PASSARO', 'Passaro Dodo');
// Parse sem as seções
$ini_array = parse_ini_file("exemplo.ini");
print_r($ini_array);
// Parse com as seções
$ini_array = parse_ini_file("exemplo.ini", TRUE);
print_r($ini_array);
?>
Irá produzir:
Array
(
[um] => 1
[cinco] => 5
[animal] => Passaro Dodo
[path] => /usr/local/bin
[URL] => http://www.example.com/~username
)
Array
(
[primeira_secao] => Array
(
[um] => 1
[cinco] => 5
[animal] => Dodo bird
)
[segunda_secao] => Array
(
[path] => /usr/local/bin
[URL] => http://www.example.com/~username
)
)