Fonction parse_ini_file()

❮ Référence du système de fichiers PHP

Exemple

Contenu du fichier "test.ini" :

[names]
me = Robert
you = Peter

[urls]
first = "http://www.example.com"
second = "https://www.formation-ti.org"

Code PHP :

<?php
print_r(parse_ini_file("test.ini"));
?>

La sortie du code ci-dessus sera :

Array (
[me] => Robert
[you] => Peter
[first] => http://www.example.com
[second] => https://www.formation-ti.org
)

Définition et utilisation

La fonction parse_ini_file() analyse un fichier de configuration (ini) et renvoie les paramètres.

Astuce : Cette fonction peut être utilisée pour lire vos propres fichiers de configuration et n'a rien à voir avec le fichier php.ini.

Remarque : Les mots réservés suivants ne doivent pas être utilisés comme clés pour les fichiers ini : null, yes, no, true, false, on, off, none. De plus, les caractères réservés suivants ne doivent pas être utilisés dans la clé : {}|&~!()^".

Syntaxe

parse_ini_file( file , process_sections , scanner_mode )

Valeurs des paramètres

Paramètre Description
file Obligatoire. Spécifie le fichier ini à analyser.
process_sections Optionnel. S'il est défini sur TRUE, il renvoie un tableau multidimensionnel avec les noms de sections et les paramètres inclus. Par défaut, c'est FALSE.
scanner_mode

Optionnel. Peut être l'une des valeurs suivantes :

  • INI_SCANNER_NORMAL (par défaut)
  • INI_SCANNER_RAW (signifie que les valeurs d'option ne seront pas analysées)
  • INI_SCANNER_TYPED (signifie que les types booléens, null et entier sont préservés lorsque cela est possible. "true", "on", "yes" sont convertis en TRUE. "false", "off", "no", "none" sont convertis en FALSE. "null" est converti en NULL. Les chaînes numériques sont converties en type entier si possible)

Détails techniques

Valeur de retour : Un tableau en cas de succès, FALSE en cas d'échec.
Version PHP : 4.0+
Journal des modifications PHP : PHP 7.0 : Les marques de hachage (#) ne sont plus reconnues comme des commentaires

Plus d'exemples

Exemple

Contenu du fichier "test.ini" :

[names]
me = Robert
you = Peter

[urls]
first = "http://www.example.com"
second = "https://www.formation-ti.org"

Code PHP (avec process_sections défini sur true) :

<?php
print_r(parse_ini_file("test.ini",true));
?>

La sortie du code ci-dessus sera :

Array
(
[names] => Array
(
[me] => Robert
[you] => Peter
)
[urls] => Array
(
[first] => http://www.example.com
[second] => https://www.formation-ti.org
)
)

❮ Référence du système de fichiers PHP