Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/geschke/docker-php-fpm-swrm

A minimal Docker image which provides a php-fpm environment with different PHP versions
https://github.com/geschke/docker-php-fpm-swrm

docker docker-image php-fpm php-fpm-environment php-fpm-swrm php74 php8 php80 php81 php82 php82-docker php83 php83-docker

Last synced: 28 days ago
JSON representation

A minimal Docker image which provides a php-fpm environment with different PHP versions

Awesome Lists containing this project

README 

        
# geschke/php-fpm-swrm



This is a minimalistic php-fpm Docker image based on the official Ubuntu images.  

The image provides different PHP versions as seen below.



## Update (October 3, 2024)



### New Build Schema



The build schema has been updated for better efficiency, flexibility, and speed. Git tags are no longer used to version Docker images, and they are now deprecated. All future images will follow the new tagging structure. The legacy Git-tagged images are no longer maintained or considered in the build process.



### Latest Image Update



The `latest` Docker image has shifted from the previous `ubuntu22.04` base (tagged `8.1-fpm-n`) to the new `ubuntu24.04` base, now tagged as `8.3-fpm-n`. Please update your workflows accordingly if you rely on the `latest` tag.



## Supported PHP versions



### Current versions



* 8.3-fpm-ubuntu24.04-sury-n - PHP 8.3 from deb.sury.org [PPA](https://launchpad.net/~ondrej/+archive/ubuntu/php/) based on Ubuntu 24.04 LTS

* 8.2-fpm-ubuntu24.04-sury-n - PHP 8.2 from deb.sury.org [PPA](https://launchpad.net/~ondrej/+archive/ubuntu/php/) based on Ubuntu 24.04 LTS



* 8.3-fpm-ubuntu22.04-sury-n - PHP 8.3 from deb.sury.org [PPA](https://launchpad.net/~ondrej/+archive/ubuntu/php/) based on Ubuntu 22.04 LTS

* 8.2-fpm-ubuntu22.04-sury-n - PHP 8.2 from deb.sury.org [PPA](https://launchpad.net/~ondrej/+archive/ubuntu/php/) based on Ubuntu 22.04 LTS

* 8.1-fpm-ubuntu22.04-sury-n - PHP 8.1 from deb.sury.org [PPA](https://launchpad.net/~ondrej/+archive/ubuntu/php/) based on Ubuntu 22.04 LTS



* 8.3-fpm-n, **latest** - PHP 8.3 included in the current Ubuntu 24.04 LTS distribution. The **latest** tag has switched to this version on 2024-10-03.

* 8.1-fpm-n - PHP 8.1 included in Ubuntu 22.04 LTS distribution. 



### Older / deprecated versions



* 8.0-fpm-ubuntu22.04-sury-n - PHP 8.0 from deb.sury.org [PPA](https://launchpad.net/~ondrej/+archive/ubuntu/php/) based on Ubuntu 22.04 LTS

* 7.4-fpm-ubuntu22.04-sury-n - PHP 7.4 from deb.sury.org [PPA](https://launchpad.net/~ondrej/+archive/ubuntu/php/) based on Ubuntu 22.04 LTS

* 7.4-fpm-n - PHP 7.4 included in the Ubuntu 20.04 LTS distribution



n = build number, higher numbers are newer builds



## Usage



To download the image run



    docker pull geschke/php-fpm-swrm



This is a minimalistic approach to build a php-fpm environment. It doesn't

need configuration (and there is currently no way to modify the options

without inheriting the image).

Additional it installs the Composer dependency manager.



This image is intended for running as PHP-FPM backend in a Docker swarm mode environment.



For sure it is possible to start the container with the legacy "docker run" command, as seen in the following example.



To start the container, just run a command like this:

  

    docker run -d --name phpfpm -p 127.0.0.1:9000:9000 \

         --volume /path/to/your/files/on/host:/var/www/html \

         geschke/php-fpm-swrm



In the above example you will start a container named "phpfpm" which mounts

the volume /path/to/your/files/on/host to the internal directory

/var/www/html.

The -p option opens the port 9000 on localhost, so any Proxy or web server

can reach the php-fpm target. If you want to access from another server,

i.e. outside the current machine, just use the -p option without limiting

the host, e.g. -p 9000:9000. But beware if you expose the port like this - without a firewall your php-fpm

installation is open to the world!



## Usage example with Nginx



To use Nginx, set up a configuration like this:



    [...|

    # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000

    #

    location ~ \.php$ {

        # Use the tcp connection

        fastcgi_pass 127.0.0.1:9000;

        # ...but not the socket

        #fastcgi_pass unix:/run/php/php7.0-fpm.sock;

        fastcgi_index index.php;

        include fastcgi.conf;

    }

    [...]



The example is from a working configuration of Nginx Ubuntu package. If not

set in the fastcgi.conf, maybe it's necessary to add the following options:



    fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;

    fastcgi_param  SCRIPT_NAME        $fastcgi_script_name;



These options are set as default in the fastcgi.conf file and could be

changed in the location settings.



At last, you have to configure the document root settings. Let's explain by

example. The PHP files on your host are installed in:



    /vol/www/phpapp1



So the volume parameter when starting the container has to be:



    -v /vol/www/phpapp1:/var/www/html



So inside the Docker container any of your PHP files could be reached within

/var/www/html.



Then you have to configure the document root as:



    root /var/www/html;



in your Nginx sites configuration file, e.g.

/etc/nginx/sites-available/default.



You can change this behaviour if you modify the SCRIPT_FILENAME option in

the Nginx fastcgi options.



## Usage example with Docker swarm mode



Have a look at some blog articles at [www.kuerbis.org](https://www.kuerbis.org) (German only, please use Google Translate).



## Credits



This image is based on the official Ubuntu image, the Ubuntu or deb.sury.org PHP packages and uses

some configuration snippets of the official PHP Docker image. Thank you all!