インストール手順

PHPでGDサポートを有効にするには、configure に--with-gd[=DIR]を指定します。ただし、DIRは GDのベースインストールディレクトリです。 PHPにバンドルされている推奨のGDライブラリを使用するには --with-gdを指定します。 GD ライブラリをコンパイルするには、libpnglibjpeg が必要です。 PHP 7.4.0 以降では、--with-gd--enable-gd (gd 拡張モジュールを有効にするかどうかを指定する) と --with-external-gd (バンドル版の libgd ではなく、外部の libgd を使うように指定する) に変わりました。

Windows の場合、GD DLL php_gd.dllphp.ini に 拡張モジュールとして指定してください。 PHP 8.0.0 より前のバージョンでは、DLL の名前は php_gd2.dll でした。

より多くの画像フォーマットを扱えるようにGDの能力を高めるには、 --with-XXXXのような形のオプションを指定します。

サポートされる画像フォーマット
画像フォーマット configure オプション
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] もconfigureオプションに追加する必要があります。 PHP 7.4.0 以降、 --with-png-dir--with-zlib-dir は削除されました。 libpngzlib は必須になっています。
xpm XPMをサポートするには--with-xpm-dir=DIR を指定します。必要なライブラリをconfigureが見つけられなかった場合は X11ライブラリのパスを追加してください。 PHP 7.4.0 以降では、 --with-xpm を代わりに使って下さい。
webp webp をサポートするには --with-webp-dir=DIR を追加してください。 PHP 7.4.0 以降では、 --with-webp を代わりに使って下さい。

注意: libpng と共に PHP をコンパイルする際、GD ライブラリとリンクされる同じバージョンを使用する必要があります。

GDがより多くのフォントを扱えるようにするには --with-XXXXのような形のオプションを指定します。

サポートされるフォントライブラリ
フォントライブラリ configure オプション
FreeType 2 FreeType 2 をサポートするには --with-freetype-dir=DIRを指定します。 PHP 7.4.0 以降では、pkg-config に依存しているので、 --with-freetype を代わりに使ってください。
ネイティブ TrueType 文字列関数 ネイティブな TrueType 文字列関数 をサポートするには --enable-gd-native-ttfを指定します (これは PHP 7.2.0 で削除されました。)

add a note

User Contributed Notes 18 notes

up
5
Qussayyon Qamaron: Qusai.zf2@gmailcom
7 years ago
#install under Ubuntu 16.04:
* if you have access to PHP7.1:
<sudo> apt install php7.1-gd && <sudo> systemctl restart apache2
* if you have access to PHP7.0:
<sudo> apt install php7.0-gd && <sudo> systemctl restart apache2

------------------------------------------------
Qussayyon Qamaron: Qusai.zf2gmailcom
up
5
james dot a dot munsch at gmail dot com
10 years ago
sudo apt-get install php5-gd && sudo service apache2 restart

To install under Ubuntu 14.04.
up
4
msc at homofaber dot com
16 years ago
It should be noted that it might be pretty easy to install gd without the need to recompile php, when using debian:

apt-get install php5-gd
up
3
florian
13 years ago
People having difficulties setting the --with-libdir option needs to set it like this :

--with-libdir=lib64

That option works fine. Doing --with-libdir=/usr/lib64 doesn't work because the configure script prepends the --prefix option before the --with-libdir option. So, doing --with-libdir=/usr/lib64 makes the configure script to look for libs in /usr/usr/lib64, which is wrong of course, and not in /usr/lib64.
up
3
Anonymous
8 years ago
For all who use php 7 and ubuntu

sudo apt-get install php7.0-gd
up
1
fabrizzio at webtux dot cl
6 years ago
php --version if result is 7.2 version

sudo apt-get install php7.2-gd
up
0
abdulbasitsaeed
5 years ago
To install PHP GD extension on an Amazon Linux AMI server, with php 7:

sudo yum install php 70-gd

Do remember to restart Apache after the installation!

sudo service httpd restart
up
0
Joseph Marlin
13 years ago
I also had to install the libgd package in addition to php5-gd:

sudo apt-get install libgd2-xpm-dev*
up
-1
Mike K
8 years ago
On Ubuntu I was missing the libpng-dev, libjpeg-dev (and in my case) libwebp-dev libraries, all gettable with apt-get.

Also once those libraries are installed, including --with-png-dir --with-jpeg-dir --with-webp-dir, without any values (i.e. =/dir) appeared to be valid ... though admittedly I didn't try without (in case the configure script autodetected them).
up
-1
boly38 at gmail dot com
13 years ago
To get GD bundled under Ubuntu, the way to recompile php5 with gd is described here (french) http://doc.ubuntu-fr.org/modules_php#php5-gd
up
-2
remalsha at gmail dot com
6 years ago
On AntergosOS ( Arch linux )

*first run >>php -v and get current php version. In my case for PHP 7.1.14

sudo pacman -S php71-gd

then restart you apache server using,

sudo systemctl restart httpd
up
-2
Parmjit Singh
3 years ago
Installation on Pop-os No need for php5 or php7.0 etc:

sudo apt install php-gd
up
-2
leyluj21 at gmail dot com
10 years ago
If you are using PHPBREW , the extension is called gd.
So you do.
```
phpbrew ext install gd
```

It will compile the extension to the core.
up
-3
octopus at logicaloctopus dot com
13 years ago
I was running PHP on a SUSE box on amazon EC2.
to get gd to work all I had to do was to run:
> yast -i php5_gd

and when that completed I just restarted apache. voila!
up
-4
tecknovice at gmail dot com
4 years ago
currently is php7.2-gd

sudo apt install php7.2-gd
up
-5
elassoto at hotmail dot com
14 years ago
If you have already compiled PHP and want to recompile '--with-gd', don't forget to run 'make clean' first!
up
-3
oskari at cellarcode dot com
1 year ago
Note if you have php-fpm installed, you have to restart the service for the installation to show up in phpinfo output...

systemctl restart php-fpm (or equivalent)
To Top