Docker PHP-FPM

Homemade PHP-FPM Docker image with additional extensions based on official PHP Debian images.

This image is mainly used for development environments but the default configurations are production-ready to handle small to medium-sized PHP sites.

• Docker Hub
• ghcr.io

Available Tags

• 8 (default)
  • 8.3, 8.2, 8.1, 8.0 (deprecated)
• 7.4 (deprecated)
• local, dockerhub, <branch>, edge, sha-<hash>, latest (default to 8)

Built-in Extensions

This image is bundled with additional extensions that should work with most modern PHP applications. Tested with WordPress, MediaWiki and Flarum.

• apcu
• bcmath
• exif
• gd (with freetype, jpeg, and webp)
• igbinary
• imagick
• intl
• msgpack
• opcache
• pdo_mysql
• pdo_pgsql
• redis
• zip

You can view full built-in extensions:

docker run --rm -it --name tmp-php-fpm sparanoid/php-fpm:edge php -m

Key Files and Directories

• /app - Default PHP working directory (WORKDIR)
• /usr/local/etc/php-fpm.conf - Global FPM settings
• /usr/local/etc/php/conf.d/ - Custom PHP configurations
• /usr/local/etc/php-fpm.d/ - PHP-FPM configurations
  • /usr/local/etc/php-fpm.d/www.conf - Default www pool settings

You can eject and inspect these configs by using the following commands:

docker run --name tmp-php -d sparanoid/php-fpm:edge
docker cp tmp-php:/usr/local/etc/ $(pwd)/ejected-php-fpm
docker rm -f tmp-php

Extra Packages

• ImageMagick
• zip
• unzip

Examples

Using this image with ejected WordPress, Nginx, MariaDB, Redis and Adminer.

Edit docker-compose.yml:

services:
  nginx:
    image: nginx:alpine
    restart: always
    ports:
      - 80:80
      - 443:443
    depends_on:
      - php
    volumes:
      - ./data/nginx:/app
      - ./config/nginx/conf.d/default.conf:/etc/nginx/conf.d/default.conf:ro

  php:
    image: sparanoid/php-fpm:8-edge
    restart: always
    depends_on:
      - redis
      - mariadb
    volumes:
      - ./data/nginx:/app

  mariadb:
    image: mariadb
    restart: always
    volumes:
      - wordpress-db:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD:-password}
      - MYSQL_DATABASE=wordpress

  redis:
    image: redis
    restart: always

  adminer:
    image: adminer
    restart: always
    ports:
      - 127.0.0.1:8080:8080
    depends_on:
      - php

volumes:
  wordpress-db:

Edit ./config/nginx/conf.d/default.conf:

  server {
    listen                  80;
    index                   index.html index.htm index.php;

    root                    /app;

    location / {
      try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
      try_files               $uri =404;
      fastcgi_pass            php:9000;
      include                 fastcgi_params;
      fastcgi_index           index.php;
      fastcgi_param           SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
  }

In order to make Redis Object Cache plugin work with Redis container. Add the following line in ./data/nginx/wp-config.php:

define( 'WP_REDIS_HOST', 'redis' );