How to Install PHP GD in Docker

avatar
Published: Nov 29, 2022

In this snippet, we'll learn how to install PHP GD with FPM and FPM-Alpine.

GD with FPM-Alpine

The alpine syntax is a bit different from the regular docker image.

FROM php:8.1.5-fpm-alpine

# ... other instructions ...

# setup GD extension
RUN apk add --no-cache \
      freetype \
      libjpeg-turbo \
      libpng \
      freetype-dev \
      libjpeg-turbo-dev \
      libpng-dev \
    && docker-php-ext-configure gd \
      --with-freetype=/usr/include/ \
      # --with-png=/usr/include/ \ # No longer necessary as of 7.4; https://github.com/docker-library/php/pull/910#issuecomment-559383597
      --with-jpeg=/usr/include/ \
    && docker-php-ext-install -j$(nproc) gd \
    && docker-php-ext-enable gd \
    && apk del --no-cache \
      freetype-dev \
      libjpeg-turbo-dev \
      libpng-dev \
    && rm -rf /tmp/*

# ... other instructions ...

GD with Non-Alpine FPM

With non-alpine image:

FROM php:8.1.0-fpm

# ... other instructions ...

# setup GD extension
RUN apt-get update && \
apt-get install -y libfreetype6-dev libjpeg62-turbo-dev libpng-dev && \
docker-php-ext-configure gd --with-freetype=/usr/include/ --with-jpeg=/usr/include/ && \
docker-php-ext-install gd

# ... other instructions ...