Fonction parse_ini_file() en PHP
Définition et utilisation
La fonction parse_ini_file() analyse un fichier de configuration et renvoie les réglages sous forme de tableau.
Syntaxe
parse_ini_file(file,process_sections)
Paramètres | Description |
---|---|
file | Obligatoire. Définit le fichier ini à vérifier. |
process_sections | Optionnel. Si configuré à true, renvoie un tableau multidimensionnel contenant le nom de chaque section et les paramètres du fichier de configuration. La valeur par défaut est false. |
Explication
La structure du fichier ini est similaire à celle de php.ini.
Les constantes peuvent également être interprétées dans le fichier ini, donc si une constante définie avant l'exécution de parse_ini_file() est utilisée comme valeur ini, elle sera intégrée aux résultats. Seules les valeurs ini sont évaluées.
Les noms de clé et de section composés de nombres sont traités comme des entiers par PHP, donc les nombres commençant par 0 sont traités comme octaux et ceux commençant par 0x comme hexadécimaux.
Avis et commentaires
Remarque :Cette fonction peut être utilisée pour lire le fichier de configuration de votre propre application. Cette fonction n'a aucun rapport avec le fichier php.ini, qui a été traité lors de l'exécution du script.
Remarque :Si la valeur de l'ini fichier contient des caractères non alphanumériques, il est nécessaire de les encadrer par des guillemets doubles (").
Remarque :Certains mots réservés ne peuvent pas être utilisés comme noms de clé dans les fichiers ini, y compris : null, yes, no, true et false. Les valeurs null, no et false sont équivalentes à "", et les valeurs yes et true sont équivalentes à "1". Les caractères {}|"~![()" ne peuvent pas être utilisés nulle part dans le nom de clé, et ces caractères ont un sens spécial dans les valeurs des options.
Remarque :Depuis la version PHP 5.0, cette fonction traite également les nouvelles lignes dans les valeurs des options.
Exemple
Exemple 1
Le contenu de "test.ini" :
[names] me = Robert you = Peter [urls] first = "http://www.example.com" second = "http://www.codew3c.com"
Code PHP :
<?php print_r(parse_ini_file("test.ini")); ?>
Sortie :
Array ( [me] => Robert [you] => Peter [first] => http://www.example.com [second] => http://www.codew3c.com )
Exemple 2
Le contenu de "test.ini" :
[names] me = Robert you = Peter [urls] first = "http://www.example.com" second = "http://www.codew3c.com"
Code PHP (process_sections Réglé sur true) :
<?php print_r(parse_ini_file("test.ini",true)); ?>
Sortie :
Array ( [names] => Array ( [me] => Robert [you] => Peter ) [urls] => Array ( [first] => http://www.example.com [second] => http://www.codew3c.com ) )