Raccourcis : Contenu - rubriques - sous rubriques
EN FR
Guide du développeur
Jelix 1.3.9

Section: jIniFileModifier: lire ou modifier des fichiers de configuration (ini)

« jImageModifier: Modifier une image ^ Les classes utilitaires jMailer : envoi de mails »

− Table des matières

jIniFileModifier aide à lire et à modifier des fichiers de configuration au format ini. Le constructeur de la classe prend un paramètre : le chemin du fichier ce qui vous oblige à instancier la classe avec le chemin du fichier à lire ou modifier.

L'avantage de cette classe est qu'elle préserve les commentaires et saut de ligne présent dans le fichier, contrairement à la fonction parse_ini_file de PHP.

  • *Attention** : Si vous souhaitez uniquement lire un fichier ini, utilisez la fonction parse_ini_file, pas jIniFileModifier. La fonction parse_ini_file est en effet largement plus performante que jIniFileModifier.

Constructeur

Le constructeur permet de lire le fichier de configuration. Attention, le nom du fichier est en chemin absolu.


// on ira lire le fichier dans le répertoire /var/config de l'application
$monfichier = jApp::configPath('exemple.ini.php');
$ini = new jIniFileModifier ($monfichier);

Fonction getValue

La fonction getValue permet de lire la valeur d'un mot clé avec une section ou pas. La fonction prend les paramètres suivant: le mot clé, la section (optionnel).

Dans le cas le mot clé ne se trouve pas dans une section, ne mettez pas le paramètre section 


$valeur = $ini->getValue($MotCle, $Section);

Fonction setValue

La fonction setValue permet de modifier la valeur d'un mot clé dans une section ou pas. La fonction prend les paramètres suivant : le mot clé, la nouvelle valeur, la section (optionnel)

Dans le cas le mot clé ne se trouve pas dans une section, ne mettez pas le paramètre section 


$ini->setValue($MotCle, $NewValeur, $Section);

Fonction save

La fonction save permet d'enregistrer le fichier après modification


$ini->save();

Fonction saveAs

La fonction save permet d'enregistrer la configuration dans un nouveau fichier (Enregistrer sous)

 $ini->saveAs();
« jImageModifier: Modifier une image ^ Les classes utilitaires jMailer : envoi de mails »
Ce manuel est distribué selon les termes de la licence Creative Commons by-nc-sa 3.0. Vous pouvez donc reproduire, modifier, distribuer et communiquer ce manuel au public en respectant les conditions suivantes : Paternité, Pas d'Utilisation Commerciale, Partage des Conditions Initiales à l'Identique.