Lire et écrire dans un fichier texte
Tentons maintenant de lire et d'écrire dans un fichier texte, fichier se trouvant sur votre serveur FTP. Afin de mettre en pratique cet exercice, vous allez créer un fichier donnees.txt que vous allez placer dans le même répertoire que le script PHP.Supposons que ce fichier texte contienne la ligne suivante :
"Salut à tous :)".
Soit alors, le code PHP suivant :
exemple1.php
<?php
// Instruction 1
$fp = fopen ("donnees.txt", "r");
// Instruction 2
$contenu_du_fichier = fgets ($fp, 255);
// Instruction 3
fclose ($fp);
// Instruction 4
echo 'Notre fichier contient : '.$contenu_du_fichier;
?>
Ce qui affichera à l'écran :
Notre fichier contient : Salut à tous :)
Détaillons alors ce qui se passe :
- Instruction 1 : on ouvre le fichier donnees.txt en lecture seule à l'aide de la fonction fopen() (la lecture seule est obtenue à l'aide du paramètre r ; nous détaillerons plus loin tous les paramètres possibles de cette fonction).
- Instruction 2 : on lit le contenu du fichier à l'aide de la fonction fgets() et l'on place le contenu de ce fichier dans la variable $contenu_du_fichier (le paramètre 255 passé à la fonction fgets() correspond au nombre de caractères à lire : ici, on a donné 255, ce qui correspond a un choix totalement arbitraire. En effet, vous pouvez mettre n'importe quel nombre. En revanche, si vous mettez 20 et que votre fichier comporte 128 caractères, seuls les 20 premiers seront lus).
- Instruction 3 : on referme le fichier donnees.txt à l'aide de la fonction fclose(). En effet, nous avons déjà le contenu du fichier dans la variable $contenu_du_fichier, alors le fichier ne nous intéresse plus.
- Instruction 4 : on affiche donc le contenu du fichier donnees.txt (notez encore une fois l'utilité de la concaténation des chaînes de caractères).
Aparté
Vous n'êtes absolument pas oblige de mettre ce fichier texte dans le même répertoire que le script PHP. En effet, si votre script PHP est à la racine de votre site et que le fichier à lire se trouve dans le répertoire /toto, vous écrirez alors votre script de la manière suivante :
exemple2.php
<?php
$fp = fopen ("toto/donnees.txt", "r");
$contenu_du_fichier = fgets ($fp, 255);
fclose ($fp);
echo 'Notre fichier contient : '.$contenu_du_fichier;
?>
Ce qui produira un résultat tout a fait identique.
Etudions maintenant tous les paramètres possibles de la fonction fopen() :
- r : ouvre en lecture seule, et place le pointeur de fichier au début du fichier.
- r+ : ouvre en lecture et écriture, et place le pointeur de fichier au début du fichier.
- w : ouvre en écriture seule; place le pointeur de fichier au début du fichier et réduit la taille du fichier à 0. Si le fichier n'existe pas, on tente de le créer.
- w+ : ouvre en lecture et écriture; place le pointeur de fichier au début du fichier et réduit la taille du fichier à 0. Si le fichier n'existe pas, on tente de le créer.
- a : ouvre en écriture seule; place le pointeur de fichier à la fin du fichier file. Si le fichier n'existe pas, on tente de le créer.
- a+ : ouvre en lecture et écriture; place le pointeur de fichier à la fin du fichier. Si le fichier n'existe pas, on tente de le créer.
Un exemple concret : un mini compteur du nombre de visites.
Tachons maintenant de voir un exemple concret de lecture et d'écriture dans un fichier texte. En effet, nous allons réaliser un mini compteur de visites fait grâce à PHP et aux lecture/écriture dans un fichier texte.
Tout d'abord vous allez créer un fichier compteur.txt que vous allez placer dans le même répertoire que le script qui va suivre. Placez le chiffre "0" dans ce fichier.
Soit alors le bout de code PHP suivant :
exemple3.php
<?php
// Instruction 1
$fp = fopen ("compteur.txt", "r+");
// Instruction 2
$nb_visites = fgets ($fp, 11);
// Instruction 3
$nb_visites = $nb_visites + 1;
// Instruction 4
fseek ($fp, 0);
// Instruction 5
fputs ($fp, $nb_visites);
// Instrcution 6
fclose ($fp);
// Instrcution 7
echo 'Ce site compte '.$nb_visites.' visiteurs !';
?>
On a alors :
- Instruction 1 : on ouvre le fichier compteur.txt en lecture et en ecriture.
- Instruction 2 : on lit le contenu du fichier et on place ce contenu (qui est donc le nombre de visiteurs de notre page) dans la variable $nb_visites.
- Instruction 3 : on augmente le nombre de visites de 1.
- Instruction 4 : on place le pointeur du fichier à l'offset 0 grâce à l'instruction fseek(). En clair, on se positionne au tout début de notre fichier.
- Instruction 5 : grâce à l'instruction fputs(), on écrit dans notre fichier la nouvelle valeur correspondant au nombre de visites.
- Instruction 6 : on ferme le fichier.
- Instruction 7 : on affiche le nombre de visites de notre page !!!
