Instalación

Para activar el soporte de GD, es necesario compilar PHP con la opción --with-gd[=DIR], donde DIR es el directorio de instalación de GD. Se recomienda utilizar la versión de GD que se distribuye con PHP, utilizando simplemente la opción --with-gd. La biblioteca GD requiere libpng y libjpeg para compilar. A partir de PHP 7.4.0, --with-gd se convierte en --enable-gd (si es necesario activar la extensión completa) y --with-external-gd (para elegir utilizar una libgd externa, en lugar de la proporcionada).

En Windows, es necesario incluir la biblioteca php_gd.dll como extensión en el archivo php.ini. Anterior a PHP 8.0.0, la DLL se llamaba php_gd2.dll.

Se amplían las capacidades de GD para manejar otros formatos de imagen especificando las siguientes opciones de compilación --with-XXXX:

Formatos de imagen soportados
Formato de imagen Opción de compilación
avif Para activar el soporte de la biblioteca avif, añadir la opción --with-avif. Disponible a partir de PHP 8.1.0.
jpeg Para activar el soporte de la biblioteca JPEG, añadir la opción --with-jpeg-dir=DIR. Jpeg 6b, 7 u 8 son soportados. A partir de PHP 7.4.0, utilizar en su lugar --with-jpeg
png Para activar el soporte de la biblioteca PNG, añadir la opción --with-png-dir=DIR. Tenga en cuenta que libpng requiere la biblioteca zlib y, por lo tanto, será necesario añadir también --with-zlib-dir[=DIR] en su línea de compilación. A partir de PHP 7.4.0, --with-png-dir y --with-zlib-dir han sido eliminadas. libpng y zlib son necesarias.
xpm Para activar el soporte de la biblioteca XPM, añadir la opción --with-xpm-dir=DIR. Si el script de compilación no es capaz de encontrar las bibliotecas necesarias, será necesario añadir la ruta hacia las bibliotecas X11. A partir de PHP 7.4.0, utilizar en su lugar --with-xpm
webp Para activar el soporte de WebP, añadir --with-vpx-dir=DIR. A partir de PHP 7.4.0, utilizar en su lugar --with-webp

Nota: Al compilar PHP con libpng, es necesario utilizar la misma versión que la vinculada a la biblioteca GD.

Se amplían las capacidades de GD para manejar diferentes tipos de fuentes de caracteres añadiendo las siguientes opciones --with-XXXX de compilación:

Bibliotecas de fuentes soportadas
Biblioteca Opción de configuración
FreeType 2 Para activar el soporte de FreeType 2, añadir la opción --with-freetype-dir=DIR. A partir de PHP 7.4.0 utilizar --with-freetype en su lugar, que depende de pkg-config.
TrueType strings Para activar el soporte de strings TrueType, añadir la opción --enable-gd-native-ttf. (Esta opción no tiene efecto y ha sido eliminada desde PHP 7.2.0.)