Установка

Для поддержки модуля GD необходимо сконфигурировать PHP с опцией --with-gd[=DIR], где DIR — директория установки GD. Чтобы использовать рекомендованную разработчиками встроенную версию библиотеки GD, указывают опцию конфигурации --with-gd. Библиотека GD требует наличия библиотек libpng и libjpeg для компиляции. С PHP 7.4.0 опция --with-gd становится --enable-gd (нужно ли вообще включать модуль) и --with-external-gd (чтобы выбрать внешнюю библиотеку libgd, а не встроенную).

В Windows-системах необходимо включить DLL-библиотеку модуля GD php_gd.dll в файле php.ini. До PHP 8.0.0 DLL-файл назывался php_gd2.dll.

Модуль GD усовершенствуют во время конфигурации PHP через опцию --with-XXXX для работы с бо́льшим количеством графических форматов.
Поддерживаемые форматы изображений

Формат изображения Опция при конфигурировании

avif Поддержку формата avif включает опция --with-avif. Доступ к опции открыли в PHP 8.1.0.

jpeg Формата jpeg — --with-jpeg-dir=DIR. Включая поддержку Jpeg 6b, 7 или 8. В PHP 7.4.0 опцию изменили на --with-jpeg.

png Формат png — --with-png-dir=DIR. Внимание, модулю libpng требуется модуль zlib, поэтому при конфигурации добавляют опцию --with-zlib-dir[=DIR]. С PHP 7.4.0 опции --with-png-dir и --with-zlib-dir удалили. Теперь модули libpng и zlib обязательны.

xpm Формат xpm — --with-xpm-dir=DIR. Если во время конфигурации не удаётся найти необходимую библиотеку, указывают путь к модулю X11. В PHP 7.4.0 опцию заменили на --with-xpm.

webp Формат webp — --with-webp-dir=DIR.

**Поддерживаемые форматы изображений**
Формат изображения	Опция при конфигурировании
`avif`	Поддержку формата avif включает опция --with-avif. Доступ к опции открыли в PHP 8.1.0.
`jpeg`	Формата jpeg — --with-jpeg-dir=DIR. Включая поддержку Jpeg 6b, 7 или 8. В PHP 7.4.0 опцию изменили на --with-jpeg.
`png`	Формат png — --with-png-dir=DIR. Внимание, модулю libpng требуется модуль zlib, поэтому при конфигурации добавляют опцию --with-zlib-dir[=DIR]. С PHP 7.4.0 опции --with-png-dir и --with-zlib-dir удалили. Теперь модули libpng и zlib обязательны.
`xpm`	Формат xpm — --with-xpm-dir=DIR. Если во время конфигурации не удаётся найти необходимую библиотеку, указывают путь к модулю X11. В PHP 7.4.0 опцию заменили на --with-xpm.
`webp`	Формат webp — --with-webp-dir=DIR.

Замечание: При компиляции PHP с модулем libpng требуется указать ту же версию libpng, с которой собрали модуль GD.

Модуль GD усовершенствуют во время конфигурирования PHP через опцию --with-XXXX для работы с бо́льшим количеством шрифтов.
Поддерживаемые библиотеки шрифтов

Библиотека шрифтов Опция при конфигурировании

FreeType 2 Поддержку шрифта FreeType 2 включает опция --with-freetype-dir=DIR. С PHP 7.4.0 вместо этого указывают опцию --with-freetype, которая зависит от команды pkg-config.

Собственная строковая функция шрифтов в формате TrueType Поддержку собственной строковой функции для шрифтов в формате TrueType включает опция --enable-gd-native-ttf. (Опция не действует, её удалили в PHP 7.2.0.)

Библиотека шрифтов	Опция при конфигурировании
`FreeType 2`	Поддержку шрифта FreeType 2 включает опция --with-freetype-dir=DIR. С PHP 7.4.0 вместо этого указывают опцию --with-freetype, которая зависит от команды pkg-config.
`Собственная строковая функция шрифтов в формате TrueType`	Поддержку собственной строковой функции для шрифтов в формате TrueType включает опция --enable-gd-native-ttf. (Опция не действует, её удалили в PHP 7.2.0.)