## Установка

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

> Замечание: При компиляции 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.)

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