Analisador de INI

Este analisador suporta seções, pares chave=valor, comentários (usando ; ou #), valores de string entre aspas e valores multilinha. Também lida com detecção de tipos booleanos e numéricos.

Este analisador lida com o formato INI padrão. Algumas extensões específicas do PHP como substituição de constantes e operadores especiais podem não ser suportadas.

Quando chaves duplicadas são encontradas na mesma seção, o último valor tem precedência. Isso segue o comportamento padrão de análise INI.

Exemplos clássicos: php.ini (toda a configuração do motor PHP), .gitconfig, a herança do win.ini no Windows, as entradas .desktop no Linux e muitos jogos e aplicações de ambiente de trabalho. As raízes do formato remontam aos anos 60-70, razão pela qual a sintaxe varia ligeiramente de sítio para sítio - as seções, os pares chave=valor e os comentários com ponto e vírgula são o núcleo estável.

Não - tudo é uma cadeia de carateres; os tipos são uma convenção do lado de quem consome o ficheiro. O parse_ini_file() do PHP converte true/on/yes/1 e false/off/no/0 em booleanos (comportamento documentado), converte valores com aparência numérica em inteiros e números de vírgula flutuante e mantém o resto como cadeias. Colocar um valor entre aspas ('1') preserva-o como cadeia de carateres no PHP. Este analisador mostra os valores tal como foram escritos.

[section] inicia uma seção que abrange todas as chaves seguintes até ao próximo cabeçalho - os blocos [PHP] e [mail function] do php.ini funcionam assim. O aninhamento é simulado com chaves com pontos (database.host = localhost) ou nomes de seção como [database.pool], já que o formato em si só tem um nível. Dados profundamente aninhados são um sinal de que o INI já lhe ficou pequeno e de que quer TOML ou YAML.

O formato base define quase nenhumas sequências de escape - os valores são tomados literalmente até ao fim da linha. Na prática: as aspas duplas agrupam valores contendo espaços e são a única forma portátil de preservar espaços em branco no início ou no fim; a interpolação ${VAR} existe em algumas implementações (o systemd, por exemplo), mas não em outras; e o facto de ; e # iniciarem comentários a meio da linha depende do analisador que consome o ficheiro.

O .env é o subconjunto plano do INI: linhas KEY=value, sem seções, consumido por bibliotecas dotenv em uma dúzia de linguagens, seguindo a metodologia de configuração da 12-Factor App. Os ficheiros INI baseiam-se nas seções e são lidos por aplicações específicas, em vez de seguirem uma convenção genérica. Os valores em .env são quase sempre cadeias de carateres injetadas em variáveis de ambiente, enquanto os consumidores de INI aplicam frequentemente as suas próprias regras de tipagem.