Analyseur INI

Cet analyseur prend en charge les sections, les paires clé=valeur, les commentaires (avec ; ou #), les valeurs de chaîne entre guillemets et les valeurs multilignes. Il gère également la détection de types booléens et numériques.

Cet analyseur gère le format INI standard. Certaines extensions spécifiques à PHP comme la substitution de constantes et les opérateurs spéciaux peuvent ne pas être prises en charge.

Lorsque des clés en double sont trouvées dans la même section, la dernière valeur prend le pas sur les précédentes. Cela suit le comportement standard d'analyse INI.

Terrains classiques : php.ini (toute la configuration du moteur PHP), .gitconfig, l'héritage de win.ini sur Windows, les entrées .desktop sur Linux, et de nombreux jeux et applications de bureau. Les racines du format remontent aux années 1960-1970, c'est pourquoi la syntaxe varie légèrement selon les endroits - les sections, key=value et les commentaires avec point-virgule constituent le noyau stable.

Non - tout est une chaîne de caractères ; les types relèvent d'une convention côté consommateur. La fonction parse_ini_file() de PHP convertit true/on/yes/1 et false/off/no/0 en booléens (comportement documenté), transforme les valeurs d'apparence numérique en entiers et en flottants, et conserve le reste sous forme de chaînes. Mettre une valeur entre guillemets ('1') la préserve en tant que chaîne en PHP. Cet analyseur affiche les valeurs brutes telles qu'écrites.

[section] démarre une section qui regroupe toutes les clés suivantes jusqu'au prochain en-tête - les blocs [PHP] et [mail function] de php.ini fonctionnent ainsi. L'imbrication est simulée avec des clés à points (database.host = localhost) ou des noms de sections comme [database.pool], puisque le format lui-même ne compte qu'un seul niveau. Des données profondément imbriquées sont le signe que vous avez dépassé INI et qu'il vous faut TOML ou YAML.

Le format de base ne définit presque aucun échappement - les valeurs sont prises littéralement jusqu'à la fin de la ligne. En pratique : les guillemets doubles délimitent les valeurs contenant des espaces et constituent la seule méthode portable pour conserver les espaces en début ou en fin de valeur ; l'interpolation ${VAR} existe dans certaines implémentations (systemd, entre autres) mais pas dans d'autres ; et le fait que ; et # démarrent des commentaires en milieu de ligne dépend du parseur qui lit le fichier.

.env est le sous-ensemble plat d'INI : des lignes KEY=value, pas de sections, consommé par des bibliothèques dotenv dans une douzaine de langages suivant la méthodologie de configuration 12-Factor App. Les fichiers INI s'appuient sur les sections et sont lus par des applications spécifiques plutôt que selon une convention générique. Les valeurs dans .env sont presque toujours des chaînes injectées dans des variables d'environnement, tandis que les consommateurs INI appliquent souvent leurs propres règles de typage.