xplodwild/nginx-php-fpm repository overview

⁠hub.docker.com/r/tiredofit/nginx-php-fpm

⁠Introduction

Dockerfile to build a Nginx⁠ w/PHP-FPM⁠ container image.

• This Container uses a customized Alpine Linux base⁠ which includes s6 overlay⁠ enabled for PID 1 Init capabilities, zabbix-agent⁠ based on 3.4 Packages for individual container monitoring, Cron also installed along with other tools (bash,curl, less, logrotate, mariadb-client, nano, vim) for easier management. It also supports sending to external SMTP servers..
• Debug Mode to Enable XDebug
• Caching is provided with w/ APC, OpCache
• All available PHP Extensions included
• Enabled by default extensions are: apcu, bcmath, ctype, curl, dom, gd, iconv, intl, json, ldap, mbstring, mcrypt, opcache, openssl, pdo, pdo_mysql, pdo_sqlite, pgsql, phar, redis, session, xml, xmlreader, zlib

Changelog⁠

⁠Authors

• Dave Conroy⁠

⁠Table of Contents

• Introduction⁠
  • Changelog⁠
• Prerequisites⁠
• Installation⁠
• Quick Start⁠
• Configuration⁠
  • Database⁠
  • Data Volumes⁠
  • Environment Variables⁠
  • Networking⁠
• Maintenance⁠
  • Shell Access⁠
  • References⁠

⁠Prerequisites

This image assumes that you are using a reverse proxy such as jwilder/nginx-proxy⁠ and optionally the Let's Encrypt Proxy Companion @ https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion⁠ in order to serve your pages. However, it will run just fine on it's own if you map appropriate ports.

⁠Installation

Automated builds of the image are available on Registry⁠ and is the recommended method of installation.

docker pull hub.docker.com/tiredofit/nginx-php-fpm:(imagetag)

The following image tags are available:

• 5.3-latest - PHP 5.3.29 w/Alpine 3.4
• 5.5-latest - PHP 5.5..38 w/Alpine 3.4
• 5.6-latest - PHP 5.6.x w/Alpine 3.5
• 7.0-latest - PHP 7.0.x w/Alpine 3.6
• 7.1-latest - PHP 7.1.x w/Alpine 3.7
• 7.1-ldap-latest - PHP 7.1.x w/LDAP Authentication w/Alpine 3.7
• 7.2-latest - PHP 7.2.x w/Alpine 3.8
• edge-latest - Most recent release of PHP w/most recent Alpine Linux

⁠Quick Start

• The quickest way to get started is using docker-compose⁠. See the examples folder for a working docker-compose.yml⁠ that can be modified for development or production use.

• Set various environment variables⁠ to understand the capabilities of this image.

• Map persistent storage⁠ for access to configuration and data files for backup.

⁠Configuration

⁠Data-Volumes

The container starts up and reads from /etc/nginx/nginx.conf for some basic configuration and to listen on port 73 internally for Nginx Status responses. /etc/nginx/conf.d contains a sample configuration file that can be used to customize a nginx server block.

The following directories are used for configuration and can be mapped for persistent storage.

⁠Database

No Database Required - MariaDB Client is located within the image.

⁠Environment Variables

Along with the Environment Variables from the Base image⁠, below is the complete list of available options that can be used to customize your installation.

Enabling / Disabling Specific Extensions

If you enable DEBUG_MODE=TRUE all extensions above will be enabled, and you will also have the ability to use XDebug. The following are the environment variables to configure XDebug. Visit the PHP XDebug Documentation⁠ to understand what these options mean.

⁠Networking

The following ports are exposed.

⁠Maintenance

⁠Shell Access

If you wish to turn the web server into maintenance mode showing a single page screen outlining that the service is being worked on, you can also enter into the container and type maintenance ARG, where ARG is either ON,OFF, or SLEEP (seconds) which will temporarily place the site in maintenance mode and then restore it back to normal after time has passed.

For debugging and maintenance purposes you may want access the containers shell.

docker exec -it (whatever your container name is e.g. nginx-php-fpm) bash

⁠References

• https://www.nginx.org⁠
• http://www.php.org⁠
• https://xdebug.org⁠