hub.docker.com/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.5
• 7.1-latest - PHP 7.1.x w/Alpine 3.6
• 7.1-ldap-latest - PHP 7.1.x w/LDAP Authentication w/Alpine 3.6
• 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.

Directory	Description
/www/html	Root Directory
/www/logs	Nginx and php-fpm logfiles

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.

Parameter	Description
MAINTENANCE	Display an Under Maintenance Page - Default: FALSE
PHP_MEMORY_LIMIT	Amount of memory php-fpm process should use - Default: 128M)
STAGE	What Stage this Image is running in DEVELOP or PRODUCTION - Passes ENV Var to PHP - Default DEVELOP
PHP_LOG_LEVEL	Define verbosity: (e.g debug, info, notice, warning, error, critical, and alert - Default: info)
PHP_TIMEOUT	Sets Read and Write Timeouts for Nginx FastCGI - Default 300)
UPLOAD_MAX_SIZE	Maximum Upload Size - Default 2G
APC_SHM_SIZE	PHP7 APC SHM Cache Size - Default 128M)
OPCACHE_MEM_SIZE	PHP7 OPCache Size - Select 0 to Disable - Default 128

Enabling / Disabling Specific Extensions

Parameter	Description
PHP_ENABLE_AMQP	amqp extension - Default FALSE
PHP_ENABLE_APCU	apcu extension - Default TRUE
PHP_ENABLE_BCMATH	bcmath extension - Default TRUE
PHP_ENABLE_BZ2	bzip2 extension - Default FALSE
PHP_ENABLE_CALENDAR	calendar extension - Default FALSE
PHP_ENABLE_CTYPE	ctype extension - Default TRUE
PHP_ENABLE_CURL	curl extension - Default TRUE
PHP_ENABLE_DBA	dba extension - Default FALSE
PHP_ENABLE_DOM	dom extension - Default TRUE
PHP_ENABLE_EMBED	embed extension - Default FALSE
PHP_ENABLE_ENCHANT	enchant extension - Default FALSE
PHP_ENABLE_EXIF	EXIF extension - Default FALSE
PHP_ENABLE_FILEINFO	fileinfo extension - Default FALSE
PHP_ENABLE_FTP	FTP extension - Default FALSE
PHP_ENABLE_GD	GD extension - Default TRUE
PHP_ENABLE_GETTEXT	gettext extension - Default FALSE
PHP_ENABLE_GMP	gmp extension - Default FALSE
PHP_ENABLE_ICONV	iconv extension - Default TRUE
PHP_ENABLE_IMAGICK	ImageMagick extension - Default FALSE
PHP_ENABLE_IMAP	IMAP extension - Default TRUE
PHP_ENABLE_INTL	INTL extension - Default TRUE
PHP_ENABLE_JSON	JSON extension - Default TRUE
PHP_ENABLE_LDAP	LDAP extension - Default TRUE
PHP_ENABLE_MAILPARSE	MAILPARSE extension - Default FALSE
PHP_ENABLE_MBSTRING	mbstring extension - Default TRUE
PHP_ENABLE_MCRYPT	mcrypt extension - Default TRUE
PHP_ENABLE_MEMCACHED	MemCached extension - Default FALSE
PHP_ENABLE_MYSQLND	MySQLND extension - Default TRUE
PHP_ENABLE_ODBC	ODBC extension - Default FALSE
PHP_ENABLE_OPCACHE	OPCACHE extension - Default TRUE
PHP_ENABLE_OPENSSL	OpenSSL extension - Default TRUE
PHP_ENABLE_PCNTL	PCNTL extension - Default FALSE
PHP_ENABLE_PDO	PDO extension - Default TRUE
PHP_ENABLE_PDO_MYSQL	PDO_MySQL extension - Default TRUE
PHP_ENABLE_PDO_PGSQL	PDO_PGSQL extension - Default FALSE
PHP_ENABLE_PDO_SQLITE	PDO_SQLITE3 extension - Default TRUE
PHP_ENABLE_PGSQL	PGSQL extension - Default TRUE
PHP_ENABLE_PHAR	PHAR extension - Default TRUE
PHP_ENABLE_POSIX	POSIX extension - Default FALSE
PHP_ENABLE_PSPELL	pspell extension - Default FALSE
PHP_ENABLE_RECODE	Recode extension - Default FALSE
PHP_ENABLE_REDIS	Redis extension - Default TRUE
PHP_ENABLE_SESSION	Session extension - Default TRUE
PHP_ENABLE_SHMOP	SHMOP extension - Default FALSE
PHP_ENABLE_SIMPLEXML	SimpleXML extension - Default FALSE
PHP_ENABLE_SNMP	SNMP extension - Default FALSE
PHP_ENABLE_SOAP	SOAP extension - Default FALSE
PHP_ENABLE_TIDY	TIDY extension - Default FALSE
PHP_ENABLE_TOKENIZER	Tokenizer extension - Default FALSE
PHP_ENABLE_WDDX	WDDX extension - Default FALSE
PHP_ENABLE_XML	XML extension - Default TRUE
PHP_ENABLE_XMLREADER	XMLReader extension - Default TRUE
PHP_ENABLE_XMLRPC	XMLRPC extension - Default FALSE
PHP_ENABLE_XMLWRITER	XMLWriter extension - Default FALSE
PHP_ENABLE_ZIP	ZIP extension - Default FALSE
PHP_ENABLE_ZLIB	Zlib extension - Default TRUE
PHP_ENABLE_ZMQ	ZeroMQ extension - Default FALSE

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.

Parameter	Description
PHP_XDEBUG_PROFILER_DIR	Where to store Profiler Logs - Default /www/logs/xdebug/
PHP_XDEBUG_PROFILER_ENABLE	Enable Profiler - Default 0
PHP_XDEBUG_PROFILER_ENABLE_TRIGGER	Enable Profiler Trigger - Default 0
PHP_XDEBUG_REMOTE_AUTOSTART	Enable Autostarting as opposed to GET/POST - Default 1
PHP_XDEBUG_REMOTE_CONNECT_BACK	Enbable Connection Back - Default 0
PHP_XDEBUG_REMOTE_ENABLE	Enable Remote Debugging - Default 1
PHP_XDEBUG_REMOTE_HANDLER	XDebug Remote Handler - Default dbgp
PHP_XDEBUG_REMOTE_HOST	Set this to your IP Address - Default 127.0.0.1
PHP_XDEBUG_REMOTE_PORT	XDebug Remote Port - Default 9090

Networking

The following ports are exposed.

Port	Description
80	HTTP

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