parse_ini_file

(PHP 4 , PHP 5)

parse_ini_file -- Interpreta um arquivo de configuração

Descriçã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 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
        )

)