PHP Docker Container Images

Table of Contents

• Docker Images
• Environment Variables
  • PHP and PHP-FPM configuration
  • Additional configuration
• PHP Extensions
• Tools
• Global Composer Packages
• -dev images
• -debug images
• Users and permissions
• Complete PHP stack
• Images based on wodby/php
• Orchestration Actions

Docker Images

!!! For better reliability we release images with stability tags (wodby/php:7.1-X.X.X) which correspond to git tags. We STRONGLY RECOMMEND using images only with stability tags.

About images:

• All images are based on Alpine Linux
• Base image: wodby/base-php (wodby/alpine for 5.3)
• Travis CI builds
• Docker Hub
• -dev and -debug images have a few differences

Supported tags and respective Dockerfile links:

• 7, 7.2, latest (Dockerfile)
• 7.1 (Dockerfile)
• 7.0 (Dockerfile)
• 5, 5.6 (Dockerfile)
• 5.3 (Dockerfile)
• 7-dev, 7.2-dev (Dockerfile)
• 7.1-dev (Dockerfile)
• 7.0-dev (Dockerfile)
• 5-dev, 5.6-dev (Dockerfile)
• 5.3-dev (Dockerfile)
• 7-debug, 7.2-debug (Dockerfile)
• 7.1-debug (Dockerfile)
• 7.0-debug (Dockerfile)
• 5-debug, 5.6-debug (Dockerfile)

The 5.3 version is no longer supported by PHP team, we highly encourage updating to 5.6

Environment Variables

PHP and PHP-FPM configuration

The default configuration is not recommended to be used for production environment:

Variable	7.2	7.1	7.0	5.6
PHP_ALLOW_URL_FOPEN	On	On	On	On
PHP_ALWAYS_POPULATE_RAW_POST_DATA	-	-	-	0
PHP_APCU_ENABLED	1	1	1	-
see all apcu ext options	7.x apcu	7.x apcu	7.x apcu	-
PHP_ASSERT_ACTIVE	On	On	On	On
PHP_BLACKFIRE
PHP_BLACKFIRE_AGENT_HOST	blackfire	blackfire	blackfire	blackfire
PHP_BLACKFIRE_AGENT_PORT	8707	8707	8707	8707
PHP_CLI_MEMORY_LIMIT	-1	-1	-1	-1
PHP_DATE_TIMEZONE	UTC	UTC	UTC	UTC
PHP_DEFAULT_SOCKET_TIMEOUT	60	60	60	60
PHP_DISPLAY_ERRORS	On	On	On	On
PHP_DISPLAY_STARTUP_ERRORS	On	On	On	On
PHP_ERROR_REPORTING	E_ALL	E_ALL	E_ALL	E_ALL
PHP_EXPOSE	Off	Off	Off	Off
PHP_FPM_CLEAR_ENV*	yes	yes	yes	yes
PHP_FPM_ENV_VARS
PHP_FPM_LOG_LEVEL*	notice	notice	notice	notice
PHP_FPM_PM	dynamic	dynamic	dynamic	dynamic
PHP_FPM_PM_MAX_CHILDREN	8	8	8	8
PHP_FPM_PM_MAX_REQUESTS	500	500	500	500
PHP_FPM_PM_MAX_SPARE_SERVERS	3	3	3	3
PHP_FPM_PM_MIN_SPARE_SERVERS	1	1	1	1
PHP_FPM_PM_STATUS_PATH
PHP_FPM_REQUEST_SLOWLOG_TIMEOUT
PHP_FPM_START_SERVERS	2	2	2	2
PHP_FPM_USER	www-data	www-data	www-data	www-data
PHP_FPM_GROUP	www-data	www-data	www-data	www-data
PHP_GEOIP_CUSTOM_DIR
PHP_LOG_ERRORS_MAX_LEN	1024	1024	1024	1024
PHP_MAX_EXECUTION_TIME	120	120	120	120
PHP_MAX_FILE_UPLOADS	20	20	20	20
PHP_MAX_INPUT_TIME	60	60	60	60
PHP_MAX_INPUT_VARS	2000	2000	2000	2000
PHP_MBSTRING_HTTP_INPUT	-	-	-
PHP_MBSTRING_HTTP_OUTPUT	-	-	-
PHP_MBSTRING_ENCODING_TRANSLATION	-	-	-	Off
PHP_MEMORY_LIMIT	512M	512M	512M	512M
PHP_MYSQL_CACHE_SIZE	-	-	-	2000
PHP_MYSQLI_CACHE_SIZE	2000	2000	2000	2000
PHP_NEWRELIC_ENABLED	-	false	false	false
PHP_NEWRELIC_LICENSE	-
PHP_NEWRELIC_APPNAME	-	My PHP app	My PHP app	My PHP app
PHP_OPCACHE_ENABLE	1	1	1	1
see all opcache ext options	7.2 opcache	7.1 opcache	7.0 opcache	5.6 opcache
PHP_OUTPUT_BUFFERING	4096	4096	4096	4096
PHP_PDO_MYSQL_CACHE_SIZE	2000	2000	2000	2000
PHP_POST_MAX_SIZE	32M	32M	32M	32M
PHP_REALPATH_CACHE_SIZE	4096k	4096k	4096k	16k
PHP_REALPATH_CACHE_TTL	120	120	120	120
PHP_SENDMAIL_PATH	/bin/true	/bin/true	/bin/true	/bin/true
PHP_SESSION_AUTO_START	0	0	0	0
PHP_TRACK_ERRORS	-	On	On	On
PHP_UPLOAD_MAX_FILESIZE	32M	32M	32M	32M
PHP_XDEBUG	-
PHP_XDEBUG_DEFAULT_ENABLE	-	0	0	0
see all xdebug ext options	7.x xdebug	7.x xdebug	7.x xdebug	5.6 xdebug
PHP_ZEND_ASSERTIONS	1	1	1	1

"-" - Not available for this version

Default value of environment variables marked with * is different for -dev and -debug images

Additional configuration

Variable	Default value
GIT_USER_EMAIL	[email protected]
GIT_USER_NAME	wodby
SSH_PRIVATE_KEY
SSH_DISABLE_STRICT_KEY_CHECKING
SSHD_GATEWAY_PORTS	no
SSHD_HOST_KEYS_DIR	/etc/ssh
SSHD_LOG_LEVEL	INFO
SSHD_PASSWORD_AUTHENTICATION	no
SSHD_PERMIT_USER_ENV	no
SSHD_USE_DNS	yes

PHP Extensions

Extension	7.2	7.1	7.0	5.6
amqp	1.9.3	1.9.3	1.9.3	1.9.1
apc	-	-	-	-
apcu	5.1.10	5.1.10	5.1.10	4.0.11
ast	0.1.6	0.1.6	0.1.6	-
blackfire	latest	latest	latest	latest
bcmath
bz2
calendar
Core
ctype
curl
date
dom
ds	1.2.4	1.2.4	1.2.4	-
exif
ereg	-	-	-
fileinfo
filter
ftp
gd
geoip	1.1.1	1.1.1	1.1.1	1.1.1
grpc	1.9.0	1.9.0	1.9.0	-
hash
iconv
imagick	3.4.3	3.4.3	3.4.3	3.4.3
imap
intl
json
ldap
libxml
mbstring
mcrypt	1.0.1
memcached	3.0.4	3.0.4	3.0.4	2.2.0
mongo	-	-	-	-
mongodb	1.4.0	1.4.0	1.4.0	1.4.0
mysql	-	-	-
mysqli
mysqlnd
newrelic	latest	latest	latest	latest
OAuth	2.0.2	2.0.2	2.0.2	1.2.3
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_pgsql
pdo_sqlite
pgsql
Phar
posix
readline
redis	3.1.6	3.1.6	3.1.6	3.1.6
Reflection
session
SimpleXML
soap
sockets
SPL
SQLite	-	-	-	-
sqlite3
standard
tokenizer
uploadprogress	latest	latest	latest	1.0.3.1
xdebug	2.6.0	2.6.0	2.6.0	2.5.5
xml
xmlreader
xmlrpc
xmlwriter
xsl
yaml	2.0.2	2.0.2	2.0.2	1.3.1
Zend OPcache
zip
zlib

Legend:

• [EMPTY] – Core PHP extension
• "-" - Not exists in this version Some extensions may not be available in -dev and -debug images

Extensions xdebug and blackfire disabled by default.

Tools

Tool	7.2	7.1	7.0	5.6
Composer	latest	latest	latest	latest
Walter	1.3.0	1.3.0	1.3.0	1.3.0

Global Composer Packages

Package	Version
hirak/prestissimo	^0.3

-dev Images

Images with -dev tag have a few differences:

• sudo allowed for all commands for wodby user
• PHP source code available under /usr/src/php.tar.xz
• PHP_FPM_CLEAR_ENV is set to no by default

-debug Images

Include all changes from -dev images and additionally:

• PHP compiled with --enabled-debug flag
• PHP binaries are not stripped from debug symbols
• Some extensions do not work with --enabled-debug such as newrelic and blackfire
• PHP_FPM_LOG_LEVEL is set to debug by default

Users and permissions

Default container user is wodby:wodby (UID/GID 1000). PHP-FPM runs from www-data:www-data user (UID/GID 82) by default. User wodby is a part of www-data group.

Codebase volume $APP_ROOT (/var/www/html) owned by wodby:wodby.

Files volume $FILES_DIR (/mnt/files) owned by www-data:www-data with 775 mode. In case you need write access for wodby user to a file/dir generated by www-data on this volume run sudo files_chmod [FILEPATH] script (FILEPATH must be under /mnt/files), it will recursively change the mode to 775.

See wodby#22 for more details.

Complete PHP stack

See wodby/docker4php for the complete PHP stack.

Images based on wodby/php

• wodby/drupal-php
• wodby/wordpress-php

Orchestration Actions

Usage:

make COMMAND [params ...]

commands:
    migrate
    check-ready [host max_try wait_seconds delay_seconds]
    git-clone url [branch]
    git-checkout target [is_hash]   
    files-import source
    files-link public_dir 
    update-keys
    walter

default params values:
    is_hash 0
    branch "" Branch, tag or hash commit