nginx-php Dockerfile

This repository contains source code of rtucek/nginx-php.

Content

Nginx and PHP are compiled in a specific version. Consult the CHANGELOG.md file for further version details. PHP Composer is already installed and ready for use.

Xdebug is installed as shared extension, but not activated. Start the container with env ENABLE_XDEBUG=1 to enable the extension.

The Nginx and PHP-FPM master processes are controlled by Honcho. Honcho was chosen over Supervisor, because honcho will exit and kill the container if either Nginx or PHP's master process dye for any reason. If you want have to have the container restarted automatically, you may want to use Docker's restart policy.

Usage

docker run -v /path/to/php/source/:/usr/local/nginx/html/ rtucek/nginx-php

# With restart policy
docker run --restart=always -v /path/to/php/source/:/usr/local/nginx/html/ rtucek/nginx-php

Advanced configuration

You by default, the image is configured to work out of the box, however you may add your own Nginx or PHP related configuration files.

Nginx

Mount your custom nginx.conf file at /usr/local/nginx/conf/nginx.conf.

docker run -v /path/to/nginx.conf:/usr/local/nginx/conf/nginx.conf ... rtucek/nginx-php

PHP & PHP-FPM

• Mount your custom php-fpm.conf file at /usr/local/etc/php-fpm.conf.
• Mount your custom www.conf file at /usr/local/etc/www.conf.
• Mount your custom php.ini file at /usr/local/php/php.ini.

Xdebug

Xdebug was installed mainly with the idea of providing code coverage for PHPUnit. Thus it's not configured for any specific use case. You can configure Xdebug via php.ini if desired.

Honcho

If you want to overwrite the default Honcho configuration - mount your custom Procfile file at /.

Todo

• Add HEALTHCHECK