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.
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.
- 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.
You can create your own containers based upon this container with a simple FROM in your Dockerfile.
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.
Now that we know all that, we can do something like this:
FROM existenz/webstack:7.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 \
php7-ctype \
php7-json \
php7-mbstring
And you should now have a working container that runs your PHP project!
Tags ending with a
-descriptioninstall 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 |
|---|---|---|
| 7.4 | Alpine Linux 3.13 | Alpine Linux repo |
| 8.0 | Alpine Linux 3.13 | Alpine Linux repo |
| 8.1 | Alpine Linux 3.16 | Alpine Linux repo |
| 8.2 | Alpine Linux 3.18 | Alpine Linux repo |
| 8.2-edge | Alpine Linux 3.17 | Alpine Linux repo |
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 (7.4) | /etc/php7/conf.d/ | /etc/php7/php.ini |
| PHP-FPM (7.4) | /etc/php7/php-fpm.d/ | /etc/php7/php-fpm.conf |
| PHP core directives (8.0) | /etc/php8/conf.d/ | /etc/php8/php.ini |
| PHP-FPM (8.0) | /etc/php8/php-fpm.d/ | /etc/php8/php-fpm.conf |
| 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 |
| Nginx | /etc/nginx/conf.d/ | /etc/nginx/nginx.conf |
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!