https://github.com/linuxeye/docker-php-fpm

Last synced: 11 months ago
JSON representation
Host: GitHub
URL: https://github.com/linuxeye/docker-php-fpm
Owner: linuxeye
License: mit
Created: 2023-03-09T00:36:52.000Z (almost 3 years ago)
Default Branch: main
Last Pushed: 2025-02-06T03:47:34.000Z (12 months ago)
Last Synced: 2025-02-06T04:21:25.514Z (12 months ago)
Language: Dockerfile
Size: 633 KB
Stars: 5
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project

README

          # PHP-FPM Docker images

**Available Architectures:**  `amd64`, `arm64`

This repository will provide you fully functional PHP-FPM Docker images in different flavours,

versions and packed with different types of integrated PHP modules. It also solves the problem of **[syncronizing file permissions](doc/syncronize-file-permissions.md)** of mounted volumes between the host and the container.

:information_source: For details see **[Documentation: Syncronize File Permissions](doc/syncronize-file-permissions.md)**

This repository also allows you to quickly generate and **build your own custom PHP-FPM Docker image** with whatever PHP extension your desire for whatever PHP version you want and for any platform you're on (`amd64` or `arm64`). Jump to **[#Build your own image](#build-your-own-image)**.

Docker Tags


```bash

docker pull bypanel/php-fpm:

```

* [`5.3-base`](Dockerfiles/base/Dockerfile-5.3), [`5.4-base`](Dockerfiles/base/Dockerfile-5.4), [`5.5-base`](Dockerfiles/base/Dockerfile-5.5), [`5.6-base`](Dockerfiles/base/Dockerfile-5.6), [`7.0-base`](Dockerfiles/base/Dockerfile-7.0), [`7.1-base`](Dockerfiles/base/Dockerfile-7.1), [`7.2-base`](Dockerfiles/base/Dockerfile-7.2), [`7.3-base`](Dockerfiles/base/Dockerfile-7.3), [`7.4-base`](Dockerfiles/base/Dockerfile-7.4), [`8.0-base`](Dockerfiles/base/Dockerfile-8.0), [`8.1-base`](Dockerfiles/base/Dockerfile-8.1), [`8.2-base`](Dockerfiles/base/Dockerfile-8.2), [`8.3-base`](Dockerfiles/base/Dockerfile-8.3), [`8.4-base`](Dockerfiles/base/Dockerfile-8.4)

* [`5.3-mods`](Dockerfiles/mods/Dockerfile-5.3), [`5.4-mods`](Dockerfiles/mods/Dockerfile-5.4), [`5.5-mods`](Dockerfiles/mods/Dockerfile-5.5), [`5.6-mods`](Dockerfiles/mods/Dockerfile-5.6), [`7.0-mods`](Dockerfiles/mods/Dockerfile-7.0), [`7.1-mods`](Dockerfiles/mods/Dockerfile-7.1), [`7.2-mods`](Dockerfiles/mods/Dockerfile-7.2), [`7.3-mods`](Dockerfiles/mods/Dockerfile-7.3), [`7.4-mods`](Dockerfiles/mods/Dockerfile-7.4), [`8.0-mods`](Dockerfiles/mods/Dockerfile-8.0), [`8.1-mods`](Dockerfiles/mods/Dockerfile-8.1), [`8.2-mods`](Dockerfiles/mods/Dockerfile-8.2), [`8.3-mods`](Dockerfiles/mods/Dockerfile-8.3), [`8.4-mods`](Dockerfiles/mods/Dockerfile-8.4)

* [`5.3-prod`](Dockerfiles/prod/Dockerfile-5.3), [`5.4-prod`](Dockerfiles/prod/Dockerfile-5.4), [`5.5-prod`](Dockerfiles/prod/Dockerfile-5.5), [`5.6-prod`](Dockerfiles/prod/Dockerfile-5.6), [`7.0-prod`](Dockerfiles/prod/Dockerfile-7.0), [`7.1-prod`](Dockerfiles/prod/Dockerfile-7.1), [`7.2-prod`](Dockerfiles/prod/Dockerfile-7.2), [`7.3-prod`](Dockerfiles/prod/Dockerfile-7.3), [`7.4-prod`](Dockerfiles/prod/Dockerfile-7.4), [`8.0-prod`](Dockerfiles/prod/Dockerfile-8.0), [`8.1-prod`](Dockerfiles/prod/Dockerfile-8.1), [`8.2-prod`](Dockerfiles/prod/Dockerfile-8.2), [`8.3-prod`](Dockerfiles/prod/Dockerfile-8.3), [`8.4-prod`](Dockerfiles/prod/Dockerfile-8.4)

:information_source: For details see **[Documentation: Docker Tags](doc/docker-tags.md)**


:information_source: For details see **[Documentation: Supported Architectures](doc/supported-architectures.md)**

PHP Versions


The following PHP versions are provided by this repository.

* `PHP 5.3`, `PHP 5.4`, `PHP 5.5`, `PHP 5.6`

* `PHP 7.0`, `PHP 7.1`, `PHP 7.2`, `PHP 7.3`, `PHP 7.4`

* `PHP 8.0`, `PHP 8.1`, `PHP 8.2`, `PHP 8.3`, `PHP 8.4`

> **Note:** Unreleased PHP versions are built from custom base images.

:information_source: For details see **[Documentation: PHP Versions](doc/php-versions.md)**


:information_source: For details see **[Documentation: Base Images](doc/base-images.md)**

Flavours


The provided Docker images heavily rely on inheritance to guarantee smallest possible image size. Each of them provide a working PHP-FPM server and you must decide what version works best for you. Look at the sketch below to get an overview about the two provided flavours and each of their different types.

```shell

        [PHP]            # Base FROM image (Official PHP-FPM image)

          ^              #

          |              #

          |              #

        [base]           # Streamlined base images with host user mapping

          ^              # environment variables and custom configs.

          |              #

          |              #

        [mods]           # Installs additional PHP modules

          ^              # via pecl, git and other means

          |              #

          |              #

        [prod]           # Devilbox flavour for production

                         # (locales, postifx, socat and injectables)

                         # (custom *.ini files)

                         #

```

:information_source: For details see **[Documentation: Flavours](doc/flavours.md)**


:information_source: For details see **[Documentation: Base Images](doc/base-images.md)**

Available PHP extensions


> Click below listed extensions for details:

[`amqp`](php_modules/amqp/)

[`apc`](php_modules/apc/)

[`apcu`](php_modules/apcu/)

[`bcmath`](php_modules/bcmath/)

[`blackfire`](php_modules/blackfire/)

[`bz2`](php_modules/bz2/)

[`calendar`](php_modules/calendar/)

[`ctype`](php_modules/ctype/)

[`curl`](php_modules/curl/)

[`date`](php_modules/date/)

[`dba`](php_modules/dba/)

[`dom`](php_modules/dom/)

[`enchant`](php_modules/enchant/)

[`ereg`](php_modules/ereg/)

[`exif`](php_modules/exif/)

[`FFI`](php_modules/ffi/)

[`fileinfo`](php_modules/fileinfo/)

[`filter`](php_modules/filter/)

[`ftp`](php_modules/ftp/)

[`gd`](php_modules/gd/)

[`gettext`](php_modules/gettext/)

[`gmp`](php_modules/gmp/)

[`hash`](php_modules/hash/)

[`iconv`](php_modules/iconv/)

[`igbinary`](php_modules/igbinary/)

[`imagick`](php_modules/imagick/)

[`imap`](php_modules/imap/)

[`interbase`](php_modules/interbase/)

[`intl`](php_modules/intl/)

[`ioncube`](php_modules/ioncube/)

[`json`](php_modules/json/)

[`ldap`](php_modules/ldap/)

[`libxml`](php_modules/libxml/)

[`lz4`](php_modules/lz4/)

[`lzf`](php_modules/lzf/)

[`mbstring`](php_modules/mbstring/)

[`mcrypt`](php_modules/mcrypt/)

[`memcache`](php_modules/memcache/)

[`memcached`](php_modules/memcached/)

[`mhash`](php_modules/mhash/)

[`mongo`](php_modules/mongo/)

[`mongodb`](php_modules/mongodb/)

[`msgpack`](php_modules/msgpack/)

[`mysql`](php_modules/mysql/)

[`mysqli`](php_modules/mysqli/)

[`mysqlnd`](php_modules/mysqlnd/)

[`OAuth`](php_modules/oauth/)

[`oci8`](php_modules/oci8/)

[`OPcache`](php_modules/opcache/)

[`openssl`](php_modules/openssl/)

[`pcntl`](php_modules/pcntl/)

[`pcre`](php_modules/pcre/)

[`PDO`](php_modules/pdo/)

[`pdo_dblib`](php_modules/pdo_dblib/)

[`PDO_Firebird`](php_modules/pdo_firebird/)

[`pdo_mysql`](php_modules/pdo_mysql/)

[`PDO_OCI`](php_modules/pdo_oci/)

[`pdo_pgsql`](php_modules/pdo_pgsql/)

[`pdo_sqlite`](php_modules/pdo_sqlite/)

[`pdo_sqlsrv`](php_modules/pdo_sqlsrv/)

[`pgsql`](php_modules/pgsql/)

[`phalcon`](php_modules/phalcon/)

[`Phar`](php_modules/phar/)

[`posix`](php_modules/posix/)

[`pspell`](php_modules/pspell/)

[`psr`](php_modules/psr/)

[`random`](php_modules/random/)

[`rdkafka`](php_modules/rdkafka/)

[`readline`](php_modules/readline/)

[`recode`](php_modules/recode/)

[`redis`](php_modules/redis/)

[`Reflection`](php_modules/reflection/)

[`session`](php_modules/session/)

[`shmop`](php_modules/shmop/)

[`SimpleXML`](php_modules/simplexml/)

[`snmp`](php_modules/snmp/)

[`soap`](php_modules/soap/)

[`sockets`](php_modules/sockets/)

[`sodium`](php_modules/sodium/)

[`solr`](php_modules/solr/)

[`SPL`](php_modules/spl/)

[`sqlite`](php_modules/sqlite/)

[`sqlite3`](php_modules/sqlite3/)

[`sqlsrv`](php_modules/sqlsrv/)

[`ssh2`](php_modules/ssh2/)

[`swoole`](php_modules/swoole/)

[`sysvmsg`](php_modules/sysvmsg/)

[`sysvsem`](php_modules/sysvsem/)

[`sysvshm`](php_modules/sysvshm/)

[`tidy`](php_modules/tidy/)

[`tokenizer`](php_modules/tokenizer/)

[`uploadprogress`](php_modules/uploadprogress/)

[`uuid`](php_modules/uuid/)

[`wddx`](php_modules/wddx/)

[`Xdebug`](php_modules/xdebug/)

[`xhprof`](php_modules/xhprof/)

[`xlswriter`](php_modules/xlswriter/)

[`xml`](php_modules/xml/)

[`xmlreader`](php_modules/xmlreader/)

[`xmlrpc`](php_modules/xmlrpc/)

[`xmlwriter`](php_modules/xmlwriter/)

[`xsl`](php_modules/xsl/)

[`yaml`](php_modules/yaml/)

[`zip`](php_modules/zip/)

[`zlib`](php_modules/zlib/)

[`zstd`](php_modules/zstd/)

[`pcov`](php_modules/pcov/)

[`uopz`](php_modules/uopz/)

:information_source: For details see **[Documentation: PHP Modules](doc/php-modules.md)**


:information_source: For details see **[Contributor Documentation: PHP Module definition](php_modules/README.md)**

Environment Variables


The provided Docker images offer environment variables to alter their startup behaviour.

:information_source: For details see **[Documentation: Environment Variables](doc/docker-env-variables.md)** or click on the variable name directly.

| Variable                                        | Short description                                             |

|-------------------------------------------------|---------------------------------------------------------------|

| [`DEBUG_ENTRYPOINT`][lnk_env_debug]             | Control docker log verbosity                                  |

| [`NEW_UID`][lnk_env_uid]                        | Syncronize user-id file system permissions                    |

| [`NEW_GID`][lnk_env_gid]                        | Syncronize group-id file system permissions                   |

| [`TIMEZONE`][lnk_env_timezone]                  | Set timezone                                                  |

| [`DOCKER_LOGS`][lnk_env_logs]                   | Make PHP log to file or docker logs                           |

| [`ENABLE_MODULES`][lnk_env_enable_mods]         | Enable specific PHP extensions                                |

| [`DISABLE_MODULES`][lnk_env_disable_mods]       | Disable specific PHP extensions                               |

| [`MYSQL_BACKUP_USER`][lnk_env_backup_user]      | Set MySQL username (for backups)                              |

| [`MYSQL_BACKUP_PASS`][lnk_env_backup_pass]      | Set MySQL password (for backups)                              |

| [`MYSQL_BACKUP_HOST`][lnk_env_backup_host]      | Set MySQL hostname (for backups)                              |

[lnk_env_debug]: doc/docker-env-variables.md#-debug_entrypoint

[lnk_env_uid]: doc/docker-env-variables.md#-new_uid

[lnk_env_gid]: doc/docker-env-variables.md#-new_gid

[lnk_env_timezone]: doc/docker-env-variables.md#-timezone

[lnk_env_logs]: doc/docker-env-variables.md#-docker_logs

[lnk_env_enable_mods]: doc/docker-env-variables.md#-enable_modules

[lnk_env_disable_mods]: doc/docker-env-variables.md#-disable_modules

[lnk_env_enable_mail]: doc/docker-env-variables.md#-enable_mail

[lnk_env_forward]: doc/docker-env-variables.md#-forward_ports_to_localhost

[lnk_env_backup_user]: doc/docker-env-variables.md#-mysql_backup_user

[lnk_env_backup_pass]: doc/docker-env-variables.md#-mysql_backup_pass

[lnk_env_backup_host]: doc/docker-env-variables.md#-mysql_backup_host

Volumes


The provided Docker images offer different volumes to be mounted.

:information_source: For details see **[Documentation: Volumes](doc/docker-volumes.md)** or click on the volume name directly.

| Volume                                             | Short description                     |

|----------------------------------------------------|---------------------------------------|

| [`/etc/php-custom.d/`][lnk_vol_php_custom]         | Add custom PHP `*.ini` files          |

| [`/etc/php-fpm-custom.d/`][lnk_vol_php_fpm_custom] | Add custom PHP-FPM `*.conf` files     |

| [`/startup.1.d/`][lnk_vol_startup1]                | Add custom startup `*.sh` files       |

| [`/startup.2.d/`][lnk_vol_startup2]                | Add custom startup `*.sh` files       |

| [`/var/log/php/`][lnk_vol_log_php]                 | Find PHP log files                    |

| [`/shared/backups/`][lnk_vol_backups]              | Find MySQL backups                    |

[lnk_vol_php_custom]: doc/docker-volumes.md#-etcphp-customd

[lnk_vol_php_fpm_custom]: doc/docker-volumes.md#-etcphp-fpm-customd

[lnk_vol_startup1]: doc/docker-volumes.md#-startup1d

[lnk_vol_startup2]: doc/docker-volumes.md#-startup2d

[lnk_vol_log_php]: doc/docker-volumes.md#-varlogphp

[lnk_vol_backups]: doc/docker-volumes.md#-sharedbackups

Ports


Have a look at the following table to see all offered exposed ports for each Docker image flavour.

 

  

   Flavour

   Port

   Description

  

 

 

  

   base
mods
prod

   9000

   PHP-FPM listening port

  

 

PHP Default Configuration


Each PHP version is using the same sane default php.ini values, making it pain-free to switch versions and not having to worry about different php.ini settings.

**Note:** Flavours alway inherit the settings from its parent flavour if they have no own configuration.

| Flavour | Applied php.ini files|

|---------|------------------------------------------|

| base    | [php.ini](Dockerfiles/base/data/php-ini.d/) and [php-fpm.conf](Dockerfiles/base/data/php-fpm.conf/) |

| mods    | inherits from base                       |

| prod    | inherits from base                       |

#### What else is available

Apart from the provided tools, you will also be able to use the container similar as you would do with your host system. Just a few things to mention here:

* Mount custom bash configuration files so your config persists between restarts

* Use password-less `sudo` to become root and do whatever you need to do

Examples


#### Provide PHP-FPM port to host

```shell

docker run -d -it \

    -p 127.0.0.1:9000:9000 \

    bypanel/php-fpm:7.2-prod

```

#### Alter PHP-FPM and system timezone

```shell

docker run -d -it \

    -p 127.0.0.1:9000:9000 \

    -e TIMEZONE=Europe/Berlin \

    bypanel/php-fpm:7.2-prod

```

#### Load custom PHP configuration

`config/` is a local directory that will hold the PHP *.ini files you want to load into the Docker container.

```shell

# Create config directory to be mounted with dummy configuration

mkdir config

# Xdebug 2

echo "xdebug.enable = 1" > config/xdebug.ini

# Xdebug 3

echo "xdebug.mode = debug" > config/xdebug.ini

# Run container and mount it

docker run -d -it \

    -p 127.0.0.1:9000:9000 \

    -v config:/etc/php-custom.d \

    bypanel/php-fpm:7.2-prod

```

#### MySQL connect via 127.0.0.1 (via port-forward)

Forward MySQL Port from `172.168.0.30` (or any other IP address/hostname) and Port `3306` to the PHP docker on `127.0.0.1:3306`. By this, your PHP files inside the docker can use `127.0.0.1` to connect to a MySQL database.

```shell

docker run -d -it \

    -p 127.0.0.1:9000:9000 \

    -e FORWARD_PORTS_TO_LOCALHOST='3306:172.168.0.30:3306' \

    bypanel/php-fpm:7.2-prod

```

#### Webserver and PHP-FPM

`~/my-host-www` will be the directory that serves the php files (your document root). Make sure to mount it into both, php and the webserver.

```shell

# Start PHP-FPM container

docker run -d -it \

    -v ~/my-host-www:/var/www/default/htdocs \

    --name php \

    bypanel/php-fpm:7.2-prod

# Start webserver and link with PHP-FPM

docker run -d -it \

    -p 80:80 \

    -v ~/my-host-www:/var/www/default/htdocs \

    -e PHP_FPM_ENABLE=1 \

    -e PHP_FPM_SERVER_ADDR=php \

    -e PHP_FPM_SERVER_PORT=9000 \

    --link php \

    bypanel/nginx

```

#### Docker Compose reference implementation

Automated builds


Docker images are built and tested every night by **[GitHub Actions](https://github.com/linuxeye/docker-php-fpm/actions?workflow=nightly)** and pushed to **[Docker hub](https://hub.docker.com/r/bypanel/php-fpm/)** on success. This is all done automatically to ensure that sources as well as base images are always fresh and in case of security updates always have the latest patches.

Build your own image


You are not interested in the provided Docker images and want to (ab)use this repository purely to generate your own custom images?

You can do so with three easy commands:

```bash

# Generate Dockerfiles with only the following PHP extensions present

make gen-dockerfiles MODS="msgpack memcached pdo_mysql rdkafka"

# Pull base image for PHP 8.1 (if you don't have it locally already)

make docker-pull-base-image STAGE=mods VERSION=8.1 ARCH=linux/arm64

# Build PHP 8.1 for arm64 with above specified extensions

make build STAGE=mods VERSION=8.1 ARCH=linux/arm64

```

:information_source: For details see **[Abuser Documentation: Build your own image](doc/abuser/README.md)**

Contributing


Contributors are welcome. Feel free to star and clone this repository and submit issues and pull-requests. Add examples and show what you have created with the provided images. If you see any errors or ways to improve this repository in any way, please do so.

:information_source: For details see **[Contributor Documentation: PHP Module definitions](php_modules/README.md)**


:information_source: For details see **[Contributor Documentation: PHP Tools definitions](php_tools/README.md)**

Credits


Thanks for contributing 🖤

- **[@cytopia](https://github.com/cytopia)**

- **[@devilbox](https://github.com/devilbox)**
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/linuxeye/docker-php-fpm

Awesome Lists containing this project

README

Docker Tags

PHP Versions

Flavours

Available PHP extensions

Environment Variables

Volumes

Ports

PHP Default Configuration

Examples

Automated builds

Build your own image

Contributing

Credits
