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, entradas .desktop no Linux, e muitos jogos e aplicativos de desktop. As raízes do formato remontam aos anos 1960-70, razão pela qual a sintaxe varia um pouco em cada lugar - seções, key=value e comentários com ponto e vírgula são o núcleo estável.

Não - tudo é string; os tipos são uma convenção do lado de quem consome. O parse_ini_file() do PHP converte true/on/yes/1 e false/off/no/0 para booleanos (comportamento documentado), transforma valores que parecem números em inteiros e floats, e mantém o restante como strings. Colocar um valor entre aspas ('1') o preserva como string no PHP. Este analisador mostra os valores brutos como foram escritos.

[section] inicia uma seção que define o escopo de todas as chaves seguintes até o 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 tem apenas um nível. Dados profundamente aninhados são sinal de que você superou o INI e quer TOML ou YAML.

O formato básico define quase nenhum escape - os valores são tomados literalmente até o fim da linha. Na prática: 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 se ; e # iniciam comentários no meio da linha depende do analisador que consome o arquivo.

.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 do 12-Factor App. Arquivos INI contam com seções e são lidos por aplicativos específicos, e não por uma convenção genérica. Valores em .env quase sempre são strings injetadas em variáveis de ambiente, enquanto consumidores de INI frequentemente aplicam suas próprias regras de tipagem.