Analizador de INI

Este analizador es compatible con secciones, pares clave=valor, comentarios (usando ; o #), valores de cadena entre comillas y valores multilínea. También maneja la detección de tipos booleanos y numéricos.

Este analizador maneja el formato INI estándar. Algunas extensiones específicas de PHP como la sustitución de constantes y operadores especiales pueden no ser compatibles.

Cuando se encuentran claves duplicadas en la misma sección, el último valor tiene precedencia. Esto sigue el comportamiento estándar de análisis INI.

Hogares clásicos: php.ini (toda la configuración del motor de PHP), .gitconfig, la herencia de win.ini en Windows, las entradas .desktop en Linux, y muchos juegos y aplicaciones de escritorio. Las raíces del formato se remontan a los años 60 y 70, por eso la sintaxis varía ligeramente en cada lugar: las secciones, los pares key=value y los comentarios con punto y coma son el núcleo estable.

No: todo es una cadena; los tipos son una convención del lado del consumidor. El parse_ini_file() de PHP convierte true/on/yes/1 y false/off/no/0 a booleanos (comportamiento documentado), transforma los valores con apariencia numérica en enteros y flotantes, y mantiene el resto como cadenas. Entrecomillar un valor ('1') lo conserva como cadena en PHP. Este analizador muestra los valores tal como están escritos.

[section] inicia una sección que abarca todas las claves siguientes hasta la próxima cabecera: los bloques [PHP] y [mail function] de php.ini funcionan así. El anidamiento se simula con claves con puntos (database.host = localhost) o nombres de sección como [database.pool], ya que el formato en sí tiene un solo nivel. Los datos profundamente anidados son señal de que INI se ha quedado corto y necesitas TOML o YAML.

El formato base prácticamente no define escapes: los valores se toman literalmente hasta el final de la línea. En la práctica: las comillas dobles agrupan valores que contienen espacios y son la única forma portable de conservar espacios al principio o al final; la interpolación ${VAR} existe en algunas implementaciones (systemd, por ejemplo) pero no en otras; y que ; o # inicien comentarios a mitad de línea depende del parser que los consuma.

.env es el subconjunto plano de INI: líneas KEY=value, sin secciones, consumido por bibliotecas dotenv en una docena de lenguajes siguiendo la metodología de configuración de 12-Factor App. Los archivos INI se apoyan en las secciones y son leídos por aplicaciones específicas en lugar de una convención genérica. Los valores en .env casi siempre son cadenas inyectadas en variables de entorno, mientras que los consumidores de INI a menudo aplican sus propias reglas de tipado.