Manual do PHP
Anterior |  | Próxima

# 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
            )

    )

Anterior | Principal | Próxima
move_uploaded_file | Acima | pathinfo