alpine-php-fpm icon indicating copy to clipboard operation
alpine-php-fpm copied to clipboard

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. :elephant:

Alpine PHP-FPM CI Docker Image

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

PHP 7.4

Docker Image Version (tag latest semver) Docker Image Size (tag)

PHP 8.0

Docker Image Version (tag latest semver) Docker Image Size (tag)

PHP 8.1

Docker Image Version (tag latest semver) Docker Image Size (tag)

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.4 v2.4 v2.4

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