(PHP 5 >= 5.3.0, PHP 7, PHP 8)
parse_ini_string — Interpreta uma string de configuração
$ini_string
, bool$process_sections
= false
, int$scanner_mode
= INI_SCANNER_NORMAL
): array|falseparse_ini_string() retorna as configurações da string ini_string
em um array associativo.
A estrutura da string INI é a mesma dos php.ini's.
ini_string
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 como INI_SCANNER_TYPED
. Nesse modo, os tipos boolean, null e integer são preservados quando possível. Os valores string "true"
, "on"
e "yes"
são convertidos em 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 o tipo inteiro, 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
efalse
,on
,off
,none
. Valoresnull
,off
,no
efalse
retornam como""
, e valoreson
,yes
etrue
resultam em"1"
, a menos que o modoINI_SCANNER_TYPED
seja usado. Os caracteres?{}|&~![()^"
não podem ser usados em lugar algum na chave e têm significado especial no valor.