## Installation

Pour activer le support de GD, vous devez 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, vous devez 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. Notez que libpng requiert la bibliothèque zlib et, donc, il vous faudra ajouter aussi --with-zlib-dir[=DIR] dans votre ligne de compilation. À partir de PHP 7.4.0, --with-png-dir et --with-zlib-dir ont été supprimée. libpng et zlib sont nécessaire.
`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 vous 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-vpx-dir=DIR. À partir de PHP 7.4.0, utiliser à la place --with-webp

> Note: Lorsque vous compilez PHP avec libpng, vous devez 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 utilisez --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 depuis PHP 7.2.0.)