Установка

Для підтримки модуля 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.)