Alpine PHP-FPM

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

v8.1	v8.2	v8.3	v8.4	v8.5

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.

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

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.

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.5 php -m

Or use php -i to get more detailed information.

docker pull joseluisq/php-fpm:8.5
# Or
docker pull joseluisq/php-fpm:8.4
# Or
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

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

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.5 sh -c "echo '<?php phpinfo();' > index.php; php -S [::]:80 -t ."
# Or
docker run --rm -p 8088:80 joseluisq/php-fpm:8.4 sh -c "echo '<?php phpinfo();' > index.php; php -S [::]:80 -t ."
# Or
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 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

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:

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

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

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

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

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 for Nginx and Apache servers can be found under the ./examples directory.

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

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

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.

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

© 2020-present Jose Quintana