Função parse_ini_file() do PHP
Definição e uso
A função parse_ini_file() analisa um arquivo de configuração e retorna os ajustes nele contidos em forma de array.
Sintaxe
parse_ini_file(file,process_sections)
| Parâmetros | Descrição |
|---|---|
| file | Obrigatório. Define o arquivo ini a ser verificado. |
| process_sections | Opcional. Se definido como true, retorna um array multidimensional que inclui o nome e as configurações de cada seção do arquivo de configuração. O valor padrão é false. |
Explicação
A estrutura do arquivo ini é semelhante à do php.ini.
Constantes também podem ser analisadas em arquivos ini, portanto, se uma constante foi definida como valor ini antes da chamada parse_ini_file(), ela será integrada aos resultados. Apenas os valores do ini serão avaliados.
Os nomes das chaves e seções compostos por números são tratados como inteiros pelo PHP, portanto, os números começando com 0 são tratados como octal e aqueles começando com 0x como hexadecimal.
Mensagens de aviso e comentários
Comentário:Esta função pode ser usada para ler o arquivo de configuração do seu próprio aplicativo. Esta função não tem relação com o arquivo php.ini, que já foi processado durante a execução do script.
Comentário:Se o valor do arquivo ini contiver caracteres não alfanuméricos, é necessário coloca-los entre aspas duplas (").
Comentário:Alguns palavras reservadas não podem ser usadas como nomes de chave em arquivos ini, incluindo: null, yes, no, true e false. Valores null, no e false são equivalentes a "", valores yes e true são equivalentes a "1". Os caracteres {}|"~![()" também não podem ser usados em nenhum lugar do nome da chave e esses caracteres têm significado especial nos valores de opções.
Comentário:A partir da versão 5.0 do PHP, a função também trata de novas linhas dentro dos valores de opções.
Exemplo
Exemplo 1
Conteúdo 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"));
?>
Saída:
Array ( [me] => Robert [you] => Peter [first] => http://www.example.com [second] => http://www.codew3c.com )
Exemplo 2
Conteúdo de "test.ini":
[names] me = Robert you = Peter [urls] first = "http://www.example.com" second = "http://www.codew3c.com"
Código PHP (process_sections Definido como true):
<?php
print_r(parse_ini_file("test.ini",true));
?>
Saída:
Array ( [names] => Array ( [me] => Robert [you] => Peter ) [urls] => Array ( [first] => http://www.example.com [second] => http://www.codew3c.com ) )
