Alpine PHP-FPM

Lightweight & optimized Multi-Arch Docker Images (x86_64/arm/arm64) for PHP-FPM (PHP 8.1, 8.2, 8.3) with essential extensions on top of latest Alpine Linux. 🐘

Stable versions

v8.1	v8.2	v8.3

PHP versions support

We only support stable PHP versions according to the PHP Release Cycle. However, you can still find legacy versions like 7.4.x or 8.0.x on Releases and Docker Hub.

Built-in extensions

curl, ftp, hash (mhash), libedit, libsodium, mbstring, mysqlnd, openssl, password-argon2, pdo-sqlite, pear, sqlite3, zlib

Additional extensions

Extension	v8.1	v8.2	v8.3
amqp	✓	✓	✓
apcu	✓	✓	✓
bcmath	✓	✓	✓
bz2	✓	✓	✓
exif	✓	✓	✓
gd	✓	✓	✓
gettext	✓	✓	✓
gmp	✓	✓	✓
imagick	✓	✓	✓
igbinary	✓	✓	✓
imap	✓	✓	✓
intl	✓	✓	✓
lz4	✓	✓	✓
memcache	✓	✓	✓
mongodb	✓	✓	✓
msgpack	✓	✓	✓
mysqli	✓	✓	✓
oauth	✓	✓	✓
opcache	✓	✓	✓
pcntl	✓	✓	✓
pdo_dblib	✓	✓	✓
pdo_mysql	✓	✓	✓
pdo_pgsql	✓	✓	✓
pdo_sqlsrv	✓ (64-bit only)	✓ (64-bit only)	✓ (64-bit only)
pgsql	✓	✓	✓
phalcon	✓	✓	✓
psr	✓	✓	✓
redis	✓	✓	✓
rdkafka	✓	✓	✓
soap	✓	✓	✓
sockets	✓	✓	✓
sqlsrv	✓ (64-bit only)	✓ (64-bit only)	✓ (64-bit only)
ssh2	✓	✓	✓
swoole	✓ (64-bit only)	✓ (64-bit only)	✓ (64-bit only)
sysvmsg	✓	✓	✓
sysvsem	✓	✓	✓
sysvshm	✓	✓	✓
tidy	✓	✓	✓
uuid	✓	✓	✓
vips	✓	✓	✓
xdebug	✓	✓	✓
xsl	✓	✓	✓
yaml	✓	✓	✓
zip	✓	✓	✓
zstd	✓	✓	✓
Others
composer	v2.7	v2.8	v2.8
Extensions file	8.1-fpm/extensions.txt	8.2-fpm/extensions.txt	8.3-fpm/extensions.txt

Footnotes

• (?) It means that this extension is obsolete/unmaintained/discouraged or simply is not supported yet.
• The mcrypt extension is obsolete. Use libsodium or openssl instead.

List all extensions included

If you want to know the whole list of the included extensions then type php -m as follows.

docker run --rm joseluisq/php-fpm:8.3 php -m

Or use php -i to get more detailed information.

Usage

docker pull joseluisq/php-fpm:8.3
# Or
docker pull joseluisq/php-fpm:8.2
# Or
docker pull joseluisq/php-fpm:8.1

🐳 Available on Docker Hub → hub.docker.com/r/joseluisq/php-fpm

Dockerfile

FROM joseluisq/php-fpm:8.3
# Or
FROM joseluisq/php-fpm:8.2
# Or
FROM joseluisq/php-fpm:8.1

Run a container

To give a Docker image a quick try, just execute any of those commands and then navigate to localhost:8088

docker run --rm -p 8088:80 joseluisq/php-fpm:8.3 sh -c "echo '<?php phpinfo();' > index.php; php -S [::]:80 -t ."
# Or
docker run --rm -p 8088:80 joseluisq/php-fpm:8.2 sh -c "echo '<?php phpinfo();' > index.php; php -S [::]:80 -t ."
# Or
docker run --rm -p 8088:80 joseluisq/php-fpm:8.1 sh -c "echo '<?php phpinfo();' > index.php; php -S [::]:80 -t ."

View Docker Compose Examples

Default paths

• Default Docker working directory: /var/www/html
• Additional PHP .ini files to load: /usr/local/etc/php/conf.d
• Custom PHP .ini file generated (only if ENV_SUBSTITUTION_ENABLE=true): /usr/local/etc/php/conf.d/default-php.ini

Configurable Environment Variables

PHP-FPM and PHP configurations can be overwritten using environment variables. To do so, just indicate the substitution of values using ENV_SUBSTITUTION_ENABLE=true (since it is disabled by default).

Below are the environment variables with their default values:

PHP-FPM

Global FPM

Settings replaced into /usr/local/etc/php-fpm.conf file.

• PHP_FPM_ERROR_LOG=/proc/self/fd/2
• PHP_FPM_LOG_LEVEL=error

FPM WWW Pool

Settings replaced into /usr/local/etc/php-fpm.d/www.conf file.

• PHP_FPM_LISTEN=9000
• PHP_FPM_USER=www-data
• PHP_FPM_GROUP=www-data
• PHP_FPM_LISTEN_OWNER=www-data
• PHP_FPM_LISTEN_GROUP=www-data

PHP Config

Settings replaced into /usr/local/etc/php/conf.d/default-php.ini file (php.ini).

• PHP_MEMORY_LIMIT=512M
• PHP_EXPOSE_PHP=On
• PHP_SESSION_GC_MAXLIFETIME=1440

Disable PHP additional extensions

The PHP additional extensions can be disabled at startup by providing the PHP_DISABLE_EXTENSIONS environment variable with one or more names. For example PHP_DISABLE_EXTENSIONS=psr,exif,bz2.

Find the valid extension names in extensions.txt file of every PHP version directory or by using php -m. For example docker run --rm joseluisq/php-fpm:8.3 php -m | grep "exif".

Docker Compose examples

docker-compose examples for Nginx and Apache servers can be found under the ./examples directory.

Nginx example

docker-compose -f examples/nginx/docker-compose.yml up

Apache example

docker-compose -f examples/apache/docker-compose.yml up

Contributions

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in current work by you, as defined in the Apache-2.0 license, shall be dual licensed as described below, without any additional terms or conditions.

Feel free to send some pull request or file an issue.

License

This work is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0).

© 2020-present Jose Quintana