Validateur INI

Chaque ligne non vide doit être un en-tête de section, comme [database], une clé avec une valeur, comme host = localhost, ou un commentaire. Une ligne qui ne correspond à aucun de ces cas, un en-tête de section non fermé, une clé vide ou une valeur entre guillemets non fermée constitue une erreur. Les erreurs rendent le fichier invalide et sont indiquées avec leur numéro de ligne.

Il suit le dialecte courant utilisé par PHP, MySQL et de nombreux outils : les clés et les valeurs sont séparées par = ou par : en l’absence de =, les commentaires commencent par ; ou #, et un ; ou # placé après des espaces dans une valeur sans guillemets commence un commentaire en ligne. Les noms de section peuvent contenir des espaces, des points et des guillemets, comme dans les sections de type Git. Les valeurs ne sont pas vérifiées quant à leur type, car INI ne définit pas de types de données.

Une clé définie deux fois dans la même section est signalée par un avertissement indiquant la ligne de la seconde définition. La plupart des analyseurs INI conservent la dernière valeur et ignorent silencieusement la précédente. Le fichier est tout de même déclaré valide.

Un en-tête de section qui apparaît à nouveau est signalé par un avertissement, et ses clés sont fusionnées avec celles de la première occurrence. Certains programmes traitent différemment les sections répétées ; il est donc généralement préférable de les regrouper.

Oui. Les clés se terminant par [] regroupent leurs valeurs dans une liste, comme dans les fichiers de configuration PHP, et leur répétition n’est pas signalée comme un doublon. La liste des sections n’affiche la clé qu’une seule fois.

Les clés qui apparaissent avant le premier en-tête de section n’appartiennent à aucune section. Elles sont répertoriées sous Global keys dans le résultat, et de nombreux outils les traitent comme des valeurs par défaut ou des paramètres de premier niveau.

Les valeurs entre guillemets doubles peuvent contenir ;, # et = et prennent en charge les séquences d’échappement \", \\, \n et \t, tandis que les valeurs entre guillemets simples sont prises littéralement. Une valeur entre guillemets qui n’est pas fermée sur la même ligne constitue une erreur. Les espaces autour des valeurs sans guillemets sont supprimés.

Le résultat répertorie chaque section avec son nombre de clés et les noms des clés, jusqu’à 200 sections et 50 clés par section, ainsi que le nombre total de sections et de clés. Jusqu’à 20 erreurs et 20 avertissements sont affichés, avec le nombre d’éventuels éléments supplémentaires.

Les noms de section sont conservés exactement tels qu’ils sont écrits : [a.b] est donc une section nommée a.b, et non une sous-section de a. Le fait qu’un programme interprète les points comme une imbrication dépend de ce programme. Le validateur vérifie uniquement que le nom n’est pas vide et que l’en-tête est fermé.

Les fichiers d’entrée peuvent atteindre 5 MiB. Pour convertir un fichier INI valide en JSON, YAML, TOML ou dans un autre format, utilisez le convertisseur de format de données, qui transforme les sections en objets.