parse_ini_file

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 é 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 .

A estrutura do arquivo ini é similar a do php.ini .

Atenção

Se o arquivo INI que você está tentando interpretar estiver mal formado , o PHP pára .

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

 
[segunda_secao

 
]

 
path

 
=

 
/

 
usr

 
/

 
local

 
/

 
bin

 
URL

 
=

 
"http

 
:

 
/

 
/www.example.com

 
/

 
~username

 
"





Exemplo 2 . exemplo de parse_ini_file( )

 
?php

 
/

 
/

 
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

 
[path

 
]

 
=

 
/

 
usr

 
/

 
local

 
/

 
bin

 
[URL

 
]

 
=

 
http

 
:

 
/

 
/www.example.com

 
/

 
~username

 
)

 
Array

 
(

 
[primeira_secao

 
]

 
=

 
Array

 
        (

 
[um

 
]

 
=

 
1

 
[cinco

 
]

 
=

 
5

 
        )

 
[segunda_secao

 
]

 
=

 
Array

 
        (

 
[path

 
]

 
=

 
/

 
usr

 
/

 
local

 
/

 
bin

 
[URL

 
]

 
=

 
http

 
:

 
/

 
/www.example.com

 
/

 
~username

 
        )

 

)