## 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 (pour activer ou non l'extension) 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. Avant PHP 8.0.0, la DLL était nommée php_gd2.dll.

Pour étendre les possibilités de GD à gérer d'autres formats d'images, il est possible de spécifier 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 sont supportés. À 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, ajouter 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 le support de WebP, ajouter --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.

Pour étendre les possibilités de GD à manipuler différents types de polices de caractères, il est possible d'ajouter 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, ajouter 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, ajouter l'option --enable-gd-native-ttf. (Cette option n'a aucun effet et a été supprimée à partir de PHP 7.2.0.)

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open