Alpine PHP-FPM

PHP-FPM (PHP 7.4, 8.0 and 8.1) with essential extensions on top of Alpine Linux 3.15.

PHP 7.4

PHP 8.0

PHP 8.1

Built-in extensions

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

Additional extensions

Extension	v7.4	v8.0	v8.1
amqp	✓	✓	✓
apcu	✓	✓	✓
bcmath	✓	✓	✓
bz2	✓	✓	✓
exif	✓	✓	✓
gd	✓	✓	✓
gettext	✓	✓	✓
gmp	✓	✓	✓
imagick	✓	✓	✓
imap	✓	✓	✓
intl	✓	✓	✓
mcrypt	✓	✓	?
memcache	✓	✓	✓
mongodb	✓	✓	✓
mysqli	✓	✓	✓
oauth	✓	✓	✓
pcntl	✓	✓	✓
pdo_dblib	✓	✓	✓
pdo_mysql	✓	✓	✓
pdo_pgsql	✓	✓	✓
pgsql	✓	✓	✓
psr	✓	✓	✓
soap	✓	✓	✓
sockets	✓	✓	✓
ssh2	✓	✓	✓
tidy	✓	✓	✓
vips	✓	✓	✓
xmlrpc	✓	?	?
xsl	✓	✓	✓
yaml	✓	✓	✓
swoole	✓	✓	✓
sysvmsg	✓	✓	✓
sysvsem	✓	✓	✓
sysvshm	✓	✓	✓
zip	✓	✓	✓
Others
composer	v2.1	v2.2	v2.2

Footnotes

(?) It means that this extension is obsolete/unmaintained/discourage or simply is not supported yet.

Usage

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

docker pull joseluisq/php-fpm:7.4
# Or
docker pull joseluisq/php-fpm:8.0
# Or
docker pull joseluisq/php-fpm:8.1

Dockerfile

FROM joseluisq/php-fpm:7.4
# Or
FROM joseluisq/php-fpm:8.0
# Or
FROM joseluisq/php-fpm:8.1

Run a container

To give it 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.1 sh -c "echo '<?php phpinfo();' > index.php; php -S [::]:80 -t ."
# Or
docker run --rm -p 8088:80 joseluisq/php-fpm:8.0 sh -c "echo '<?php phpinfo();' > index.php; php -S [::]:80 -t ."
# Or
docker run --rm -p 8088:80 joseluisq/php-fpm:7.4 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 it so, just indicates the substitution of values using ENV_SUBSTITUTION_ENABLE=true (since it is disabled by default).

Below 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

Docker Compose Examples

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

Nginx

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

Apache

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 some 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