(PHP 5 >= 5.3.0, PHP 7)
parse_ini_string — Interpreta uma string de configuração
$ini
[, bool $process_sections
= false
[, int $scanner_mode
= INI_SCANNER_NORMAL
]] ) : array
parse_ini_string() retorna as configurações da string
ini
em um array associativo.
A estrutura da string INI é a mesma dos php.ini's.
ini
O conteúdo do arquivo ini sendo interpretado.
process_sections
Definindo o último parâmetro process_sections
como TRUE
, você recupera um array multidimensional com o nome
das seções e configurações inclusas. O padrão para
process_sections
é FALSE
scanner_mode
O parâmetro pode ser INI_SCANNER_NORMAL
(default) ou
INI_SCANNER_RAW
. Se INI_SCANNER_RAW
for fornecido, então os valores das opçoes não serão analisados.
A partir do PHP 5.6.1 também pode ser especificado INI_SCANNER_TYPED
.
Nesse modo os tipos boolean, null e inteiro são preservados quando possível.
Valores string "true", "on" e "yes"
são convertidos para TRUE
. "false", "off", "no"
e "none" são considerados FALSE
. "null" é convertido para NULL
no modo tipado. Além disso todas as strings numéricas são convertidas para inteiros, se possível.
As configurações são retornadas como um array associativo, se sucesso
e FALSE
caso falhe.
Nota: Existem algumas palavras reservadas que não podem ser usadas como chaves em arquivos INI. Elas incluem: null, yes, no, true e false, on, off, none. Valores null, off, no e false retornam como "", e valores on, yes e true resultam em "1", a menos que o modo
INI_SCANNER_TYPED
seja usado. Os caracteres {}|&~![()" não podem ser usados em lugar algum na chave e têm significado especial no valor.