Função PHP parse_ini_file()
❮ Referência do sistema de arquivos PHPExemplo
Conteúdo de "test.ini":
[names]
me = Robert
you = Peter
[urls]
first = "http://www.example.com"
second = "https://www.w3schools.com"
Código PHP:
<?php
print_r(parse_ini_file("test.ini"));
?>
A saída do código acima será:
Array
(
[me] => Robert
[you] => Peter
[first] => http://www.example.com
[second] => https://www.w3schools.com
)
Definição e uso
A função parse_ini_file() analisa um arquivo de configuração (ini) e retorna as configurações.
Dica: Esta função pode ser usada para ler seus próprios arquivos de configuração e não tem nada a ver com o arquivo php.ini.
Nota: As seguintes palavras reservadas não devem ser usadas como chaves para arquivos ini: null, yes, no, true, false, on, off, none. Além disso, os seguintes caracteres reservados não devem ser usados na chave: {}|&~!()^".
Sintaxe
parse_ini_file(file, process_sections, scanner_mode)
Valores de parâmetro
Parameter | Description |
---|---|
file | Required. Specifies the ini file to parse |
process_sections | Optional. If set to TRUE, it returns is a multidimensional array with section names and settings included. Default is FALSE |
scanner_mode |
Optional. Can be one of the following values:
|
Detalhes técnicos
Valor de retorno: | Uma matriz em caso de sucesso, FALSE em caso de falha |
---|---|
Versão do PHP: | 4.0+ |
Registro de alterações do PHP: | PHP 7.0: As marcas de hash (#) não são mais reconhecidas como comentários PHP 5.6.1: Adicionado modo INI_SCANNER_TYPED PHP 5.3: Adicionado parâmetro opcional scanner_mode |
Mais exemplos
Exemplo
Conteúdo de "test.ini":
[names]
me = Robert
you = Peter
[urls]
first = "http://www.example.com"
second = "https://www.w3schools.com"
Código PHP (com process_sections definido como true):
<?php
print_r(parse_ini_file("test.ini",true));
?>
A saída do código acima será:
Array
(
[names] => Array
(
[me] => Robert
[you] => Peter
)
[urls] => Array
(
[first] => http://www.example.com
[second] => https://www.w3schools.com
)
)
❮ Referência do sistema de arquivos PHP