Docker Webstack

About

This container is a fairly simple Nginx / PHP-FPM container that can be used as a base for your own web containers. It makes use of s6-overlay as it's init daemon / process supervisor, and comes in various PHP versions (see below). It is rebuilt and tested every day on Travis-CI, so you will always have the latest security patches of Nginx and PHP on hand.

Why?

I can hear you thinking "aren't there already plenty good Nginx / PHP containers out there?". To me, there weren't, as I found that all existing containers either run some kind of bash script to start both Nginx and PHP, or use supervisord to start one or more processes in the background. The former felt really hacky to me, and the latter is not meant to be used as an init daemon as it does not handle the different signals for process 1 properly and makes your container possibly end up with zombie processes.

So I started looking for proper init daemons that can take care of this situation and I found s6-overlay which explains in great detail how they overcame the aforementioned problems.

The goals of this container

• Be always up to date with the latest packages from Alpine Linux
• Minimize the lines of code needed in your own Dockerfile and optimize readibility.
• Have sane defaults for Nginx, PHP, and FPM that can be easily overwritten if needed.

How can I use it?

You can create your own containers based upon this container with a simple FROM in your Dockerfile.

Before you start

Before start hacking away, you should know this:

• Nginx runs under the system's nginx user, and PHP-FPM runs under the system's php user.
• The code should be copied into /www, as this is the default directory Nginx and PHP work with in this container.
• When not using a CMS or framework like Laravel / Symfony / WordPress that brings its own public folder, copy to /www/public instead.
• Any PHP modules needed in your project should be installed by using apk, Alpine Linux's package manager and the package names for installing can be looked up in the version table below.

Then there are some tips or rather guidelines that I adhere to personally, but ultimately this is just a matter of taste:

• S6-overlay can set permissions when the container starts up, but this can be slow if a lot of permissions need to be set, so just do this when building the container.

Basic example

Now that we know all that, we can do something like this:

FROM existenz/webstack:8.3

COPY --chown=php:nginx src/ /www

RUN find /www -type d -exec chmod -R 555 {} \; \
    && find /www -type f -exec chmod -R 444 {} \; \
    && find /www/var -type d -exec chmod -R 755 {} \; \
    && find /www/var -type f -exec chmod -R 644 {} \; \
    && apk -U --no-cache add \
    php83-ctype \
    php83-json \
    php83-mbstring

And you should now have a working container that runs your PHP project!

Versions

Tags ending with a -description install packages from different repositories to keep up with the latest PHP versions. These are probably short-lived and will be replaced with their default counterpart as soon as these PHP versions make it into the default Alpine repositories. You can use them, just keep in mind you will have to switch over to the default container at one point.

Codecasts containers are no longer provided, see this issue for more information.

See the table below to see what versions are currently available:

Image tag	Based on	PHP Packages from	S6-Overlay
8.1	Alpine Linux 3.18	Alpine Linux repo	Version 1
8.2	Alpine Linux 3.19	Alpine Linux repo	Version 1
8.3	Alpine Linux 3.19	Alpine Linux repo	Version 3
8.4	Alpine Linux 3.21	Alpine Linux repo	Version 3

Overriding or extending the configuration

If you want to augment of replace the configuration of Nginx, PHP or FPM, there are multiple options:

• Place one or more configuration files in specific directories to augment the configuration
• If that does not suit your needs, you can also simply overwrite the configuration files altogether

These are the files to add or overwrite in order to configure the different parts of the webstack:

Application	Copy files into this directory	Overwrite this file if needed
PHP core directives (8.1)	/etc/php81/conf.d/	/etc/php81/php.ini
PHP-FPM (8.1)	/etc/php81/php-fpm.d/	/etc/php81/php-fpm.conf
PHP core directives (8.2)	/etc/php82/conf.d/	/etc/php82/php.ini
PHP-FPM (8.2)	/etc/php82/php-fpm.d/	/etc/php82/php-fpm.conf
PHP core directives (8.3)	/etc/php83/conf.d/	/etc/php83/php.ini
PHP-FPM (8.3)	/etc/php83/php-fpm.d/	/etc/php83/php-fpm.conf
PHP core directives (8.4)	/etc/php84/conf.d/	/etc/php84/php.ini
PHP-FPM (8.4)	/etc/php84/php-fpm.d/	/etc/php84/php-fpm.conf
Nginx	/etc/nginx/conf.d/	/etc/nginx/nginx.conf

Bugs, questions, and improvements

If you found a bug or have a question, please open an issue on the GitHub Issue tracker. Improvements can be sent by a Pull Request against the master branch and are greatly appreciated!

Contributors

Thanks everyone for helping out with this project!