OUJOOD.COM
La librairie GD pour dessiner avec PHP
Sommaire
- La librairie GD — introduction
- La librairie GD — création d'une image
- Liste des fonctions GD
- Déclaration des images avec PHP GD
- Les couleurs et les lignes en PHP GD
- Dessiner des rectangles avec PHP GD
- Dessiner des arcs avec PHP GD
- Les ellipses et les cercles
- La fonction polygones
- Ajouter un texte sur une image
- Exemple pratique : graphe de visiteurs d'un site web
Introduction : PHP peut aussi créer des images
Quand on apprend PHP, on pense d'abord à générer du HTML, des formulaires ou des requêtes en base de données. Mais PHP est capable de bien plus : il peut créer et modifier des images à la volée, directement côté serveur, sans avoir besoin d'un logiciel de retouche externe.
C'est la librairie GD qui rend cela possible. Intégrée à PHP depuis la version 4.3, elle permet de produire des fichiers images dans plusieurs formats courants : PNG, JPEG, GIF, WBMP et XPM. En 2026, GD reste la solution la plus simple et la plus portable pour générer des images dynamiques en PHP, notamment pour créer des graphiques, des captchas, des miniatures ou des bannières personnalisées.
Avant de pouvoir utiliser GD, il faut s'assurer qu'elle est bien activée dans votre configuration PHP. C'est ce que nous allons voir en premier.
Vérifier que la librairie GD est installée
La première chose à faire avant d'écrire le moindre code de dessin, c'est de confirmer que GD est disponible sur votre serveur. En effet, selon l'hébergement ou l'environnement de développement utilisé, GD peut être présente ou absente.
PHP fournit une fonction native pour cela : gd_info(). Elle retourne un tableau associatif avec toutes les informations sur la version de GD installée. Si elle renvoie un résultat vide ou si elle n'existe pas, GD n'est pas active.
Créez un fichier PHP à la racine de votre serveur, collez le code suivant, puis ouvrez-le dans votre navigateur :
<?php // Affiche la version de PHP actuellement utilisée echo "Vous utilisez PHP " . phpversion(); // Récupère les informations sur la librairie GD $gd_info = gd_info(); // Si GD n'est pas disponible, on arrête le script avec un message clair if (!$gd_info) { die("<br>La librairie GD n'est pas installée sur ce serveur."); } // Si GD est bien présente, on affiche sa version echo "<br>Librairie GD détectée : version " . $gd_info['GD Version']; ?>
Si vous voyez s'afficher un message du type « Librairie GD détectée : version 2.x », tout est en ordre et vous pouvez passer à la suite de ce tutoriel. Si vous obtenez une erreur, pas de panique : la section suivante explique comment activer GD selon votre environnement.
Activer la librairie GD selon votre environnement
L'activation de GD dépend du système sur lequel vous travaillez. Voici les trois cas les plus fréquents en 2026.
1. Sous Linux (serveur dédié ou VPS)
Sur un serveur Linux, GD s'active en modifiant le fichier de configuration php.ini. Ce fichier se trouve généralement à l'un de ces emplacements :
/etc/php.ini/etc/php/8.x/cli/php.ini(selon votre version de PHP)
Ouvrez le fichier et ajoutez ou décommentez la ligne suivante :
; Ajoutez cette ligne dans votre php.ini pour activer GD sous Linux
extension=gd.so
Vous pouvez aussi l'ajouter directement en ligne de commande sans ouvrir le fichier manuellement :
# Commande à exécuter dans le terminal pour ajouter l'extension GD
echo extension=gd.so >> /etc/php.ini
Pensez à redémarrer Apache ou PHP-FPM après cette modification pour que le changement soit pris en compte.
Sur les distributions modernes comme Ubuntu 22.04 ou Debian 12, il est encore plus simple d'installer GD directement via le gestionnaire de paquets :
# Installez l'extension GD pour PHP 8.x sous Ubuntu/Debian sudo apt install php8.3-gd # Puis redémarrez le serveur web sudo systemctl restart apache2
2. Sous EasyPHP (Windows)
EasyPHP est un environnement de développement local pour Windows. Pour activer GD, rendez-vous dans le dossier d'installation d'EasyPHP, puis ouvrez le sous-dossier apache. Recherchez le fichier php.ini et retirez le point-virgule ; situé devant la ligne suivante :
; Supprimez le ";" devant cette ligne pour activer GD sous EasyPHP/Windows
extension=php_gd2.dll
Enregistrez le fichier et redémarrez EasyPHP. La librairie GD sera alors disponible.
3. Sous WAMP (Windows)
Bonne nouvelle : avec WAMP, la librairie GD est activée par défaut depuis plusieurs années. Si vous travaillez avec WAMP, vous n'avez rien à faire : GD est déjà opérationnelle. Vérifiez-le simplement avec le script de détection présenté plus haut.
Pourquoi utiliser GD plutôt qu'une autre solution ?
En 2026, il existe plusieurs alternatives à GD pour manipuler des images en PHP, notamment Imagick (basée sur ImageMagick) ou des bibliothèques comme Intervention Image. Alors pourquoi apprendre GD en premier ?
Parce que GD est la solution la plus légère, la plus universellement disponible et la plus simple à prendre en main pour un débutant. Elle ne nécessite aucune dépendance externe, elle est incluse dans PHP par défaut sur la quasi-totalité des hébergements mutualisés, et sa documentation est abondante. C'est le choix idéal pour apprendre les bases de la génération d'images côté serveur.
Une fois à l'aise avec GD, vous pourrez évaluer d'autres outils si vos besoins deviennent plus avancés (traitement d'images complexes, effets avancés, grands volumes).
Par carabde | Mis à jour le 29 mars 2026