Le langage PHP
Partie 4 sur 5
8Lire et écrire des fichiers
Avec PHP, lire et écrire un fichier est simple. Le script communique avec le fichier par une variable qui représente son état (une « ressource »), qu’on passe aux fonctions spécialisées. La fonction de base est fopen(nom, mode), qui ouvre un fichier pour le lire, le créer ou y écrire. Le mode est une lettre ou une suite :
r(read) : lecture seulement ;w(write) : écriture seulement, le fichier est créé s’il n’existe pas et son contenu précédent est effacé ;a(append) : écriture à la fin du fichier, sans effacer, le fichier est créé s’il n’existe pas ;r+,w+,a+: lecture et écriture, avec les mêmes différences pour la création et la position ;- la lettre
bajoutée au mode indique un traitement binaire.
La fonction fopen peut ouvrir un fichier présent sur le Web, grâce à son adresse : on peut ainsi récupérer le contenu d’une page, ou y écrire par FTP (un protocole de transfert de fichiers). Cette possibilité existe encore (réglage allow_url_fopen), mais est généralement déconseillée : elle fait dépendre le script de machines extérieures et ouvre des risques (partie C.2). Pour récupérer une page, on emploie une bibliothèque de requêtes web.
8.1Lire et écrire
Une fois le fichier ouvert, on utilise fgets pour lire une ligne (avec une longueur maximale), fputs (ou fwrite, qui est un autre nom de la même fonction, c’est-à-dire un alias) pour écrire, et feof pour savoir si la fin est atteinte. Il est donc courant de lire en boucle : while (!feof($fp)) { $ligne = fgets($fp, 255); ... }. En cas d’échec, fgets renvoie false (et non 0, comme on le lit parfois). Un fichier ouvert doit toujours être refermé par fclose(). Il faut aussi tester le succès de l’ouverture et arrêter le script avec exit en cas d’échec.
Pour enregistrer des informations, on recommande le mode a plutôt que w, puisque le pointeur se trouve en fin de fichier : on écrit à la suite sans écraser. Un exemple classique stocke un nom et une adresse électronique séparés par un trait vertical. Attention : si deux visiteurs écrivent en même temps, les lignes peuvent se mélanger. On protège l’écriture avec un verrou (flock), ou mieux on utilise une base de données.
8.2D’autres façons de lire
Il existe aussi des raccourcis. file(nom) renvoie le fichier sous forme d’un tableau dont chaque élément est une ligne (le premier est à l’indice 0). fpassthru() envoie directement le reste du fichier au navigateur à partir de la position courante. Aujourd’hui, file_get_contents(nom) lit tout un fichier dans un texte et file_put_contents(nom, texte) l’écrit, ce qui remplace la plupart des boucles.
8.3Tester les fichiers et parcourir les dossiers
PHP fournit des fonctions de test : is_dir() (est-ce un répertoire ?), is_file() (un fichier ordinaire, ni répertoire ni lien), is_link() (un lien symbolique, c’est-à-dire un raccourci) et is_executable() (le fichier est-il exécutable ?). Elles renvoient true ou false (et non 1 ou 0, comme on le lit parfois). Un script récursif descendait dans les dossiers d’un site avec opendir et readdir pour en afficher l’arborescence, en repérant les fichiers HTML et en lisant leurs balises meta avec get_meta_tags. On utilise maintenant scandir(), glob() ou la classe RecursiveDirectoryIterator, plus courtes.
Une règle de sécurité capitale : ne jamais construire un chemin de fichier avec un texte venu d’un visiteur. Un nom comme ../../secret permet de sortir du dossier prévu (attaque dite « de traversée de répertoire »). Utilisez une liste de fichiers autorisés, ou basename() et un contrôle du chemin réel.
Pour s’exercer
Exercice 5 : choisir le mode d’ouverture
Vous voulez ajouter une ligne à un journal sans effacer les anciennes lignes. Quel mode de fopen choisir ? Quel problème peut survenir si le site est très visité, et que faire ?
Voir la réponse
Le mode a (ajout à la fin). Si deux visiteurs écrivent en même temps, les lignes peuvent se mélanger : on utilise un verrou (flock) ou, plus simplement, file_put_contents($nom, $ligne, FILE_APPEND | LOCK_EX), ou une base de données.
9Envoyer et lire du courrier
Le service le plus utilisé sur Internet étant la messagerie (voir le courrier électronique), PHP offre une fonction d’envoi, mail(destinataire, sujet, message, en-têtes). Le quatrième paramètre, facultatif, permet d’ajouter des en-têtes : l’adresse d’expédition (From), l’adresse de réponse (Reply-To), des copies (Cc) et des copies cachées (Bcc), la date, le logiciel d’envoi. On construisait souvent ces en-têtes en concaténant des lignes séparées par \n.
Certains hébergeurs, dont Free, désactivaient mail() parce qu’elle permet d’envoyer un courrier en prétendant venir de n’importe quelle adresse, et la remplaçaient par une fonction email() qui n’autorise que l’adresse du propriétaire. Cette fonction est propre à cet hébergeur et n’existe pas dans PHP. La remarque, elle, reste juste : forger l’adresse d’un expéditeur est facile, d’où les mécanismes d’authentification des domaines (voir le spam).
9.1Pratiques actuelles
- Ne jamais mettre dans le sujet ou dans les en-têtes une donnée du visiteur sans vérifier qu’elle ne contient pas de retour à la ligne : un retour à la ligne permet d’injecter des en-têtes, par exemple d’ajouter des destinataires cachés, et de transformer votre formulaire de contact en relais de spam.
- Envoyer par un compte authentifié auprès d’un serveur de courrier (protocole SMTP, celui de l’envoi) plutôt que par la fonction directe, avec une bibliothèque comme PHPMailer ou Symfony Mailer qui gère les en-têtes et les pièces jointes proprement.
- Publier pour son domaine les contrôles SPF, DKIM et DMARC (trois mécanismes de vérification de l’expéditeur), qui permettent aux destinataires de vérifier l’expéditeur (voir le spam).
9.2Lire une boîte aux lettres : les fonctions IMAP
Voici les fonctions IMAP. IMAP (Internet Message Access Protocol) est un protocole datant de 1986 qui permet d’accéder à une messagerie en laissant les messages sur le serveur. On lit parfois qu’il a été « supplanté par POP, plus simple », ce qui est l’inverse de la réalité : POP, qui télécharge les messages, est aujourd’hui rare, et IMAP est le protocole dominant. Les fonctions principales étaient imap_open (ouvrir une boîte, désignée par « {serveur:port}INBOX », 143 étant le port habituel), imap_check (état de la boîte : date, nombre de messages, messages récents), imap_num_msg (nombre de messages), imap_header (en-tête d’un message : expéditeur, destinataire, sujet, date, taille, etc.), imap_body (corps), imap_delete et imap_expunge (supprimer puis purger), et imap_close.
Le même module savait lire des serveurs POP et NNTP (serveurs de groupes de discussion). Deux mises à jour : le port 143 n’est pas chiffré, on utilise la version protégée sur le port 993 ; et l’extension IMAP n’est plus livrée avec PHP depuis la version 8.4, il faut l’ajouter séparément ou utiliser une bibliothèque qui parle le protocole. Enfin, les exemples d’autrefois laissaient un mot de passe en clair dans le script et utilisaient la fonction eregi, supprimée.
Pour s’exercer
Exercice 6 : le formulaire de contact piégé
Un formulaire de contact copie le champ « email » du visiteur dans l’en-tête From de mail(). Quel risque, et quelles protections ?
Voir la réponse
Si le champ contient un retour à la ligne suivi d’un nouvel en-tête, le visiteur peut ajouter des destinataires ou changer le sujet : le formulaire devient un relais de spam (injection d’en-têtes). Protections : valider l’adresse (filter_var($email, FILTER_VALIDATE_EMAIL)), refuser tout retour à la ligne, utiliser une adresse d’expédition fixe du site et mettre l’adresse du visiteur dans Reply-To, envoyer via un compte authentifié.
10Dessiner des images
PHP permet de créer des images grâce à la bibliothèque GD, une extension qui doit être activée à l’installation (à l’époque, par l’option --with-gd de la compilation). On ne parlait autrefois que de GIF ; aujourd’hui, GD gère aussi PNG, JPEG et WebP. On prévenait que créer des images met le processeur à rude épreuve et on conseillait de réserver cette technique à des usages bien choisis, comme des diagrammes statistiques à barres ou en secteurs, ou des boutons dynamiques.
10.1Le principe
Un script qui produit une image ne peut pas envoyer de texte au navigateur. Il doit d’abord envoyer un en-tête HTTP qui annonce le type du contenu, avec la fonction header("Content-Type: image/png") (et non headers, comme on l’écrit parfois par erreur), avant toute autre sortie. L’image est ensuite appelée depuis une page HTML par une balise <img src="graphique.php">. La fonction imagecreate(largeur, hauteur) crée une image vierge ; pour des couleurs vraies, on préfère aujourd’hui imagecreatetruecolor. Les fonctions imagepng(), imagejpeg() (et non imagejpg, souvent écrit par erreur) et imagegif() envoient le résultat au navigateur, ou l’écrivent sur disque si l’on donne un nom de fichier. Pour partir d’une image existante, on utilise imagecreatefromgif (et non « createimagefromgif », comme on le voit parfois). Depuis PHP 8, une image est un objet que PHP libère seul.
10.2Couleurs et formes
La plupart des fonctions de dessin ont besoin d’une couleur. imagecolorallocate(image, rouge, vert, bleu) réserve une couleur à partir de ses trois composantes, chacune de 0 à 255 (ou 0x00 à 0xFF en hexadécimal, voir l’hexadécimal). Par exemple imagecolorallocate($image, 255, 0, 0) donne du rouge. Les fonctions de formes prennent l’image, des coordonnées en pixels, puis la couleur : imageline et imagedashedline (trait plein ou pointillé), imagerectangle et imagefilledrectangle, imagepolygon et imagefilledpolygon, imageellipse (donc le cercle) et imagearc (l’arc, dont les angles sont mesurés à partir de trois heures dans le sens des aiguilles d’une montre). imagefill remplit une zone d’une couleur à partir d’un point, et imagefilltoborder remplit jusqu’à une bordure.
10.3Écrire du texte dans l’image
imagestring(image, police, x, y, texte, couleur) écrit un texte à l’endroit voulu. PHP propose des polices intégrées numérotées de 1 à 5 (on lit parfois « de 0 à 5 », ce qui n’est pas cohérent), et on peut charger une police avec imageloadfont. imagechar écrit un seul caractère, imagecharup et imagestringup les écrivent à la verticale. imagefontwidth et imagefontheight donnent la taille d’un caractère, ce qui permet de calculer la largeur d’un texte (largeur d’un caractère multipliée par le nombre de caractères). Pour des polices modernes, on utilise imagettftext avec un fichier de police.
10.4L’exemple du diagramme circulaire
Un long script, fourni par le webmestre d’un autre site, dessinait un diagramme circulaire des navigateurs des visiteurs. Les navigateurs étaient stockés dans une table (le champ « navigateur » recevait la valeur de $HTTP_USER_AGENT). Le script comptait, avec des expressions régulières, les versions de Netscape 3 et 4 et d’Internet Explorer 3, 4 et 5, calculait les angles de chaque part, dessinait arcs et rayons, remplissait chaque secteur d’une teinte de bleu, puis écrivait une légende avec le nombre et le pourcentage. Il illustrait bien le principe, mais il s’appuyait sur des navigateurs disparus et sur des fonctions supprimées (mysql_*, ereg). Aujourd’hui, pour un graphique de statistiques, on envoie plutôt les nombres à une bibliothèque JavaScript ou on produit un dessin vectoriel SVG, plus net et plus léger. Autre usage historique de GD, les images de « captcha » (lettres déformées), n’arrête plus les programmes modernes de reconnaissance d’image.