bryanlatten/docker-php repository overview

⁠docker-php

Provides a pre-wired, configurable PHP + Nginx setup across multiple runtime versions.

Integrated with Behance’s docker-nginx⁠

Available on Docker Hub⁠.

⁠Quick-start

• docker run bryanlatten/docker-php:7.0 "php" "-v"
• docker run bryanlatten/docker-php:7.1 "php" "-v"
• docker run bryanlatten/docker-php:7.1-alpine "php" "-v"
• docker run bryanlatten/docker-php:7.2-beta "php" "-v"

Adding code to runtime, see here⁠.
PHP tuning and configuration, see here⁠.
Nginx tuning and configuration, see here⁠.
Adding startup logic, basic⁠ or advanced⁠.

⁠Container tag scheme: PHP_MAJOR.PHP_MINOR(-Major.Minor.Patch)(-variant)

• PHP_MAJOR.PHP_MINOR, required. Engine versions of PHP. ex. docker-php:7.1
• (Major.Minor.Patch), optional. Semantically versioned container provisioning code. ex. docker-php:7.1-12.4.0.
• (-variant), optional. Alpine variants are slim versions of the container. ex. docker-php:7.1-alpine.

⁠Includes

• Nginx⁠ HTTP server
• PHP / PHP-FPM: primary runtime
• S6⁠: PID 1 zombie reaping, startup coordination, shutdown signal transferal. Nginx and PHP are preconfigured to shutdown as gracefully as possible.
• Goss⁠: for serverspec-like testing. Run goss -g /tests/php-fpm/{PHP_MAJOR.PHP_MINOR}(-variant).goss.yaml to validate any configuration updates
• Ubuntu (default) or Alpine OS base⁠
• Extra PHP Modules:

* - not available on -alpine variant
^ - not available on 7.2 ~ - disabled by default (default: use phpenmod to enable, Alpine-only: uncomment .ini file)

• apcu
• bcmath
• bz2
• calendar
• ctype
• curl
• date
• dom
• exif
• cgi-fcgi
• gd
• gearman*
• iconv
• igbinary
• intl
• json
• mbstring
• mcrypt^
• memcache*
• memcached
• msgpack
• mysqli
• mysqlnd
• newrelic~^ (activates with env variables)
• opcache
• openssl
• pcntl
• pdo
• pdo_mysql
• pdo_pgsql~
• pgsql~
• phar
• posix
• redis~
• shmop
• SimpleXML
• sockets
• sysvmsg
• sysvsem
• sysvshm
• tokenizer
• xdebug~^
• xml
• xmlreader
• xmlwriter
• yaml~
• zip
• zlib

⁠Expectations

Sample Dockerfile

FROM bryanlatten/docker-php:7.1

# (optional, recommended) Verify everything is in order from the parent
RUN goss -g /tests/php-fpm/7.1.goss.yaml validate && /aufs_hack.sh

# Layer local code into runtime
COPY ./ /app/

# Done!

• Local code should be copied into /app, for example: COPY ./ /app/

• Nginx is pre-configured to use a front controller PHP file (entrypoint) a front controller called index.php within a public folder. /app/public/index.php

• Dev Mode (no ENV variables): PHP's opcache is enabled, and is set to check files for updates. Code can be developed locally in Docker by mounting into the /app folder. For example, the docker-compose.yml syntax:

volumes:
   - ./:/app

• Production Mode [recommended]: using ENV variable, CFG_APP_DEBUG=0. Container becomes immutable, PHP's opcache is configured to not check files for updates.
• NOTE: Nginx is exposed and bound to an unprivileged port, 8080.

⁠Monitoring

• NewRelic APM: automatically enabled by adding providing environment variables REPLACE_NEWRELIC_APP and REPLACE_NEWRELIC_LICENSE
• PHP-FPM Status: available only inside container at /__status. Application healthcheck can pull PHP-FPM statistics from http://127.0.0.1/__status?json. To open to more clients than local, add more allow statements in __status location block in $CONF_NGINX_SITE(/etc/nginx/sites-available/default)
• Nginx Status: available only inside container at /__nginx_status. Application healthcheck can pull nginx statistics from http://127.0.0.1/__nginx_status. To open to more clients than local, add more allow statements in __nginx_status location block in $CONF_NGINX_SITE (/etc/nginx/sites-available/default)

⁠Downstream Configuration

Several environment variables can be used to configure various PHP FPM paramaters, as well as a few Nginx configurations. as such. These can be used to drive the configuration of the downstream PHP application in any way necessary, but there are a few environment variables that bryanlatter/docker-php will process along the way...

See parent(s) docker-nginx⁠, docker-base⁠ for additional configuration

⁠Testing

• Requires docker and docker-compose
  To test locally, run bash -e ./test.sh {docker-machine} where docker-machine is the IP of the connected docker engine. These same tests get run automatically, per pull request, via Travis CI