Установка

Для поддержки модуля 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-системах, вы должны включить модуль GD DLL php_gd.dll в php.ini. До PHP 8.0.0, DLL-файл назывался php_gd2.dll.

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

Поддерживаемые форматы изображений

Формат изображения	Опция при конфигурировании
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 для работы с разными шрифтами можно, указав опцию --with-XXXX во время конфигурации PHP.

Поддерживаемые библиотеки шрифтов

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