/docker-php-extensions

An extension of the official PHP Docker, with additional extensions configured and installed.

Primary LanguageDockerfileMIT LicenseMIT

PHP in Docker

A collection of PHP extensions bundled as super lightweight Docker images that make it simple to add & enable extensions in your custom PHP Docker images.

Supported PHP versions: 8.0, 8.1, 8.2

Table of contents

Usage

Using an extension in your custom image is a simple process consisting of two steps:

  1. Copy in all files from the garbetjie/php extension image.
  2. Run the setup script that installs any additional packages & performs any additional setup required by the extension.
FROM php:8.0.22-cli-alpine3.15 AS php-80

# Copy in the extensions.
COPY --from=garbetjie/php:8.0-pdo_mysql / /
COPY --from=garbetjie/php:8.0-opcache / /
COPY --from=garbetjie/php:8.0-xdebug / /

# Run the setup script.
RUN wget -O- https://raw.githubusercontent.com/garbetjie/docker-php/main/install-dependencies.sh | sh


FROM php:8.2.1-cli-alpine3.17 AS php-82

COPY --from=garbetjie/php:8.2-mysqli / /
COPY --from=garbetjie/php:8.2-grpc / /

RUN wget -O- https://raw.githubusercontent.com/garbetjie/docker-php/main/install-dependencies.sh | sh

Extension images are tagged based on their short PHP version (8.0, 8.1 or 8.2), and the extension name as shown in the output of php -m.

For example, the grpc extension can be fetched from the garbetjie/php:8.2-grpc image.

Available extensions

The table below shows a support matrix of the available extensions, as well as which platforms & PHP versions they're available for:

extension Arch: linux/amd64 Arch: linux/arm64 PHP 8.1 PHP 8.2 PHP 8.3
amqp ✅ ✅ ✅ ✅ ✅
apcu ✅ ✅ ✅ ✅ ✅
bcmath ✅ ✅ ✅ ✅ ✅
bz2 ✅ ✅ ✅ ✅ ✅
ds ✅ ✅ ✅ ✅ ✅
exif ✅ ✅ ✅ ✅ ✅
gd ✅ ✅ ✅ ✅ ✅
gettext ✅ ✅ ✅ ✅ ✅
gmp ✅ ✅ ✅ ✅ ✅
grpc ✅ ✅ ✅ ✅ ✅
igbinary ✅ ✅ ✅ ✅ ✅
imagick ✅ ✅ ✅ ✅ ✅
imap ✅ ✅ ✅ ✅ ✅
intl ✅ ✅ ✅ ✅ ✅
memcached ✅ ✅ ✅ ✅ ✅
memprof ✅ ✅ ✅ ✅ ✅
mongodb ✅ ✅ ✅ ✅ ✅
msgpack ✅ ✅ ✅ ✅ ✅
newrelic ✅ ✅ ✅ ✅ ✅
opcache ✅ ✅ ✅ ✅ ✅
opentelemetry ✅ ✅ ✅ ✅ ✅
pcntl ✅ ✅ ✅ ✅ ✅
pdo_mysql ✅ ✅ ✅ ✅ ✅
pdo_sqlsrv ✅ ❌ ✅ ✅ ✅
protobuf ✅ ✅ ✅ ✅ ✅
redis ✅ ✅ ✅ ✅ ✅
snappy ✅ ✅ ✅ ✅ ✅
soap ✅ ✅ ✅ ✅ ✅
sockets ✅ ✅ ✅ ✅ ✅
sqlsrv ✅ ❌ ✅ ✅ ✅
ssh2 ✅ ✅ ✅ ✅ ✅
swoole ✅ ✅ ✅ ✅ ✅
uopz ✅ ✅ ✅ ✅ ✅
xdebug ✅ ✅ ✅ ✅ ✅
yaml ✅ ✅ ✅ ✅ ✅
zip ✅ ✅ ✅ ✅ ✅