Kurulum

GD desteğini etkin kılmak için PHP --with-gd[=DiZiN] seçeneği ile derlenmelidir; buradaki DiZiN GD'nin kurulu olduğu dizindir. GD kütüphanesinin PHP ile dağıtılan sürümünü kullanmak için PHP --with-gd seçeneğiyle derlenmelidir. GD kütüphanesi libpng ve libjpeg desteğini gerektirir. PHP 7.4.0'dan itibaren --with-gd seçeneği, --enable-gd (eklenti etkinleştirilecekse) ve --with-external-gd (paketlenmiş olan yerine harici bir libgd kullanmayı tercih etmek için) haline gelir.

Windows'ta, GD DLL php_gd.dll dosyası php.ini dosyasında bir eklenti olarak belirtilmelidir. PHP 8.0.0 öncesinde DLL ismi php_gd2.dll idi.

GD'nin yetenekleri daha fazla görüntü biçemi kullanmak üzere genişletilmek istenirse PHP'yi derlemek için yapılandırırken --with-XXXX seçenekleri kullanılmalıdır.

Desteklenen görüntü biçemleri

Görüntü Biçemi	Yapılandırma Anahtarı
avif	Avif desteğini etkinleştirmek için --with-avif seçeneği kullanılır. PHP 8.1.0'dan itibaren kullanılabilir.
jpeg	Jpeg desteğini etkinleştirmek için --with-jpeg-dir=DiZiN seçeneği kullanılır. Jpeg 6b, 7 veya 8 desteklenir. PHP 7.4.0 ve sonrasında bu seçenek yerine --with-jpeg seçeneği kullanılır.
png	PNG desteğini etkinleştirmek için --with-png-dir=DiZiN seçeneği kullanılır. libpng zlib kütüphanesini gerektirdiğinden --with-zlib-dir[=DiZiN] seçeneği de gerekecektir. PHP 7.4.0 ve sonrasında --with-png-dir ve --with-zlib-dir seçenekleri kaldırılmış olup libpng ve zlib gerekmektedir.
xpm	XPM desteğini etkinleştirmek için --with-xpm-dir=DiZiN seçeneği kullanılır. Eğer yapılandırma betiği kütüphanelerinizin yerini bulamazsa X11 kütüphanelerinin kurulu olduğu yol belirtilmelidir. PHP 7.4.0 ve sonrasında bunun yerine --with-xpm kullanılmaktadır.
webp	Webp desteğini etkinleştirmek için --with-webp-dir=DiZiN seçeneği kullanılır. PHP 7.4.0 ve sonrasında bunun yerine --with-webp kullanılmaktadır.

Bilginize: PHP'yi libpng desteği ile derlerken, libpng ile ilintili GD sürümü kullanılmalıdır.

GD'nin yeteneklerini farklı yazıtiplerini kullanacak şekilde genişletmek için kurulum sırasında bunu --with-XXXX yapılandırma seçeneği ile belirtmek gerekir.

Desteklenen yazıtipi kütüphaneleri

Yazıtipi Kütüphanesi	Yapılandırma Seçeneği
FreeType 2	FreeType 2 desteğini etkinleştirmek için --with-freetype-dir=DiZiN seçeneği kullanılır. PHP 7.4.0 ve sonrasında bunun yerine kütüphaneyi pkg-config ile bulan --with-freetype seçeneği kullanılmaktadır.
Doğal TrueType dizge işlevi	Doğal TrueType dizge işlevi desteğini etkinleştirmek için --enable-gd-native-ttf seçeneği kullanılır. (Bu seçenek etkisiz olup PHP 7.2.0 ve sonrasında kaldırılmıştır.)