Skip to content

Latest commit

 

History

History
201 lines (154 loc) · 9.78 KB

README.md

File metadata and controls

201 lines (154 loc) · 9.78 KB
Raw

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

Table of Contents

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

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