Installation

Pour activer le support de GD, il faut compiler PHP avec l'option --with-gd[=DIR], où DIR est le dossier d'installation de GD. Il est recommandé d'utiliser la version de GD qui est distribuée avec PHP, en utilisant simplement l'option --with-gd. La bibliothèque GD requiert libpng et libjpeg pour compiler. À partir de PHP 7.4.0, --with-gd devient --enable-gd (s'il faut activer l'extension tout) et --with-external-gd (pour choisir d'utiliser une libgd externe, plutôt que celle fournie).

Sous Windows, il faut inclure la bibliothèque php_gd.dll comme extension dans le fichier php.ini. Antérieur à PHP 8.0.0, la DLL était nommée php_gd2.dll.

Augmentez les possibilités des GD de gérer d'autres formats d'images en spécifiant les options --with-XXXX de compilation suivantes :

Formats d'image supportés

Format d'image	Option de compilation
avif	Pour activer le support de la bibliothèque avif, ajouter l'option --with-avif. Disponible à partir de PHP 8.1.0.
jpeg	Pour activer le support de la bibliothèque JPEG, ajouter l'option --with-jpeg-dir=DIR. Jpeg 6b, 7 ou 8 est supporté. À partir de PHP 7.4.0, utiliser à la place --with-jpeg
png	Pour activer le support de la bibliothèque PNG, ajouter l'option --with-png-dir=DIR. Il est à noter que libpng requiert la bibliothèque zlib et, donc, il faudra ajouter aussi --with-zlib-dir[=DIR] dans la ligne de compilation. À partir de PHP 7.4.0, --with-png-dir et --with-zlib-dir ont été supprimées. libpng et zlib sont nécessaires.
xpm	Pour activer le support de la bibliothèque XPM, ajoutez l'option --with-xpm-dir=DIR. Si le script de compilation n'est pas capable de trouver les bibliothèques nécessaires, il faudra ajouter le chemin vers les bibliothèques X11. À partir de PHP 7.4.0, utiliser à la place --with-xpm
webp	Pour activer la prise en charge de WebP, ajoutez --with-webp-dir=DIR. À partir de PHP 7.4.0, utiliser à la place --with-webp

Note: Lorsqu'on compile PHP avec libpng, il faut utiliser la même version que celle liée à la bibliothèque GD.

Augmentez les possibilités de GD pour qu'elle manipule différents types de polices de caractères en ajoutant les options --with-XXXX de compilation suivantes :

Bibliothèques des polices de caractères supportées

Bibliothèque	Option de configuration
FreeType 2	Pour activer le support de FreeType 2, ajoutez l'option --with-freetype-dir=DIR. À partir de PHP 7.4.0 utiliser --with-freetype à la place, qui dépend de pkg-config.
Chaînes TrueType	Pour activer le support des chaînes de caractères TrueType, ajoutez l'option --enable-gd-native-ttf. (Cette option n'a aucun effet et a été supprimée à partir de PHP 7.2.0.)