Docker PHP7-FPM with composer support

Alpine based PHP7-FPM docker image with often used extensions, composer and proxy support.

Visit Project on Docker Hub

Table of contents

• Installed extensions
• PHP configuration
• Build Image
• Build behind a (company) proxy
• Run behind a Proxy
• Example build arguments

Installed extensions

• mysqli
• pdo-mysql
• zip
• bzip2
• intl
• Xdebug
• OPcache
• APCu
• OpenLDAP
• SPL_TYPES

PHP configuration

Override settings by customizing the template before building or by mounting your own php.ini file as /usr/local/etc/php/php.ini at runtime.

The configuration for Xdebug is located in /usr/local/etc/php/conf.d/xdebug.ini.

Build Image

You can use the docker-compose.yml file for an easy setup of build arguments.

Trigger a build with following command:

docker-compose build php

In order to do it without compose-file, the associated command line switch would be --build-arg:

docker build \
  --build-arg TZ="Europe/Berlin" \
  --build-arg INTL="de_DE" \
  --build-arg […] \
  ./

System timezone and locale for PHP's ICU/intl extension can be set via build-arguments TZ and INTL. Otherwise they have a fallback to the defaults TZ="UTC" and INTL="en".

The [Date] and [intl] sections will be appended to the php.ini file during build. They aren't necessary in the /conf/php.ini file.

The template /conf/xdebug.ini stores default Xdebug settings.

Build behind a (company) proxy

The http_proxy, https_proxy, ftp_proxy, no_proxy arguments aren't persisted as environment variables. A proxy (and it's excluded hosts) is only set during build time via an .env file to accomplish a successful connection to the download servers with extensions and composer.

Drop your own certificates into /conf/ssl/certs/ folder if you have to connect through a SSL secured (company) proxy and therefore need a certificate file. Certificates at build time are permanently stored in the image file, make sure it's only the public part and not containing the private key for more security.

Run behind a Proxy

The advantage to not store the http_proxy, https_proxy, ftp_proxy, no_proxy variables permanently in the environment is, that you can enable/disable the proxy anytime by setting the corresponding environment variables at runtime via command line or within a project's .env file. Otherwise you would have to explicitly unset or override them as soon the proxy address is changed. And multiple instances behind different proxies would require a certain amount of image rebuilds.

This is where the permanent stored certificates become handy. Simply drop several in the designated folder for an arbitrary amount of proxies. You can then decide for every single container, whether it should use a proxy and which one (since you have all necessary public keys built-in).

Example build arguments

Following argument list is an example to build an image with system timezone settings for Germany and suitable locale, used for formatting, transliteration, conversion, … with PHP's ICU/intl extension.

TZ:          "Europe/Berlin"
INTL:        "de_DE"

If you don't need some variables, simply prefix these lines with a # to comment them out.