Instalación

Para activar el soporte de GD, es necesario compilar PHP con la opción --with-gd[=DIR], donde DIR es el directorio de instalación de GD. Se recomienda utilizar la versión de GD que se distribuye con PHP, utilizando simplemente la opción --with-gd. La biblioteca GD requiere libpng y libjpeg para compilar. A partir de PHP 7.4.0, --with-gd se convierte en --enable-gd (si es necesario activar la extensión completa) y --with-external-gd (para elegir utilizar una libgd externa, en lugar de la proporcionada).

En Windows, es necesario incluir la biblioteca php_gd.dll como extensión en el archivo php.ini. Anterior a PHP 8.0.0, la DLL se llamaba php_gd2.dll.

Se amplían las capacidades de GD para manejar otros formatos de imagen especificando las siguientes opciones de compilación --with-XXXX:

Formatos de imagen soportados
Formato de imagen Opción de compilación
avif Para activar el soporte de la biblioteca avif, añadir la opción --with-avif. Disponible a partir de PHP 8.1.0.
jpeg Para activar el soporte de la biblioteca JPEG, añadir la opción --with-jpeg-dir=DIR. Jpeg 6b, 7 u 8 son soportados. A partir de PHP 7.4.0, utilizar en su lugar --with-jpeg
png Para activar el soporte de la biblioteca PNG, añadir la opción --with-png-dir=DIR. Tenga en cuenta que libpng requiere la biblioteca zlib y, por lo tanto, será necesario añadir también --with-zlib-dir[=DIR] en su línea de compilación. A partir de PHP 7.4.0, --with-png-dir y --with-zlib-dir han sido eliminadas. libpng y zlib son necesarias.
xpm Para activar el soporte de la biblioteca XPM, añadir la opción --with-xpm-dir=DIR. Si el script de compilación no es capaz de encontrar las bibliotecas necesarias, será necesario añadir la ruta hacia las bibliotecas X11. A partir de PHP 7.4.0, utilizar en su lugar --with-xpm
webp Para activar el soporte de WebP, añadir --with-vpx-dir=DIR. A partir de PHP 7.4.0, utilizar en su lugar --with-webp

Nota: Al compilar PHP con libpng, es necesario utilizar la misma versión que la vinculada a la biblioteca GD.

Se amplían las capacidades de GD para manejar diferentes tipos de fuentes de caracteres añadiendo las siguientes opciones --with-XXXX de compilación:

Bibliotecas de fuentes soportadas
Biblioteca Opción de configuración
FreeType 2 Para activar el soporte de FreeType 2, añadir la opción --with-freetype-dir=DIR. A partir de PHP 7.4.0 utilizar --with-freetype en su lugar, que depende de pkg-config.
TrueType strings Para activar el soporte de strings TrueType, añadir la opción --enable-gd-native-ttf. (Esta opción no tiene efecto y ha sido eliminada desde PHP 7.2.0.)

add a note

User Contributed Notes 18 notes

up
5
Qussayyon Qamaron: Qusai.zf2@gmailcom
8 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
4
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
4
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
2
fabrizzio at webtux dot cl
6 years ago
php --version if result is 7.2 version

sudo apt-get install php7.2-gd
up
2
Anonymous
8 years ago
For all who use php 7 and ubuntu

sudo apt-get install php7.0-gd
up
1
abdulbasitsaeed
6 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
1
Joseph Marlin
14 years ago
I also had to install the libgd package in addition to php5-gd:

sudo apt-get install libgd2-xpm-dev*
up
0
Mike K
9 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
0
boly38 at gmail dot com
14 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
-1
Parmjit Singh
4 years ago
Installation on Pop-os No need for php5 or php7.0 etc:

sudo apt install php-gd
up
-1
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
-2
remalsha at gmail dot com
7 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
octopus at logicaloctopus dot com
14 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
-3
tecknovice at gmail dot com
5 years ago
currently is php7.2-gd

sudo apt install php7.2-gd
up
-2
oskari at cellarcode dot com
2 years 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)
up
-4
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!
To Top