docker-php-extension-installer/README.md

Easy installation of PHP extensions in official PHP Docker images

This repository contains a script that can be used to easily install a PHP extension inside the official PHP Docker images.

Known limits

Currently the script requires the Debian-based images (no Alpine).

Usage

Here's a sample Dockerfile that installs the GD and xdedub extensions inside a docker image:

FROM php:7.2-cli

ADD https://raw.githubusercontent.com/mlocati/docker-php-extension-installer/master/install-php-extensions /usr/local/bin/

RUN chmod uga+x /usr/local/bin/install-php-extensions && sync && \
    install-php-extensions gd xdebug

Supported PHP extensions

Extension	PHP 5.6	PHP 7.0	PHP 7.1	PHP 7.2
apcu		V	V	V
bcmath	V	V	V	V
bz2	V	V	V	V
calendar	V	V	V	V
cmark		V	V	V
dba	V	V	V	V
enchant	V	V	V	V
exif	V	V	V	V
gd	V	V	V	V
gettext	V	V	V	V
gmp	V	V	V	V
imagick	V	V	V	V
imap	V	V	V	V
interbase	V	V	V	V
intl	V	V	V	V
ldap	V	V	V	V
mcrypt	V	V	V	V
memcache	V
memcached	V	V	V	V
mysql	V
mysqli	V	V	V	V
odbc	V	V	V	V
opcache	V	V	V	V
pcntl	V	V	V	V
pdo_dblib	V	V	V	V
pdo_firebird	V	V	V	V
pdo_mysql	V	V	V	V
pdo_odbc	V	V	V	V
pdo_pgsql	V	V	V	V
pdo_sqlsrv		V	V	V
pgsql	V	V	V	V
pspell	V	V	V	V
pthreads	V	V
recode	V	V	V	V
redis	V	V	V	V
shmop	V	V	V	V
snmp	V	V	V	V
soap	V	V	V	V
sockets	V	V	V	V
solr	V	V	V
sqlsrv		V	V	V
ssh2	V	V	V	V
sybase_ct	V
sysvmsg	V	V	V	V
sysvsem	V	V	V	V
sysvshm	V	V	V	V
tidy	V	V	V	V
timezonedb	V	V	V	V
uuid	V	V	V	V
wddx	V	V	V	V
xdebug	V	V	V	V
xmlrpc	V	V	V	V
xsl	V	V	V	V
yaml	V	V	V	V
zip	V	V	V	V

PS: the pre-installed PHP extensions are excluded from this list. You can list them with the following command (change php:7.2-cli to reflect the PHP version you are interested in):

docker run --rm -it php:7.2-cli php -m

Special requirements

Some extension has special requirements:

Extension	Requirements
pthreads	Requires images with PHP compiled with thread-safety enabled (zts).

How to contribute

• If you want to add support for a new PHP extension:
  1. change the install-php-extensions script
  2. update the data/supported-extensions file, adding a new line with the handle of the extension and the list of supported PHP versions
  3. if the extension requires ZTS images:
     add a new line to the data/special-requirements file, with the extension handle followed by a space and zts
• If you want to change the list of supported PHP versions for an already supported extension:
  1. change the install-php-extensions script
  2. update the data/supported-extensions file, adding the new PHP version to the existing line corresponding to the updated extension