parse_ini_string

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

parse_ini_string — Interpreta uma string de configuração

Descrição

parse_ini_string(string $ini_string, bool $process_sections = false, int $scanner_mode = INI_SCANNER_NORMAL): array|false

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

Parâmetros

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.

Valor Retornado

As configurações são retornadas como um array associativo, se sucesso e false caso falhe.

Notas

Note: 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.

Veja Também