PHP Docker Container Images

Table of Contents

• Docker Images
  • -dev
  • -dev-macos
  • Supported architectures
• Environment Variables
  • PHP and PHP-FPM configuration
  • Additional configuration
• Build arguments
• PHP Extensions
• Tools
• Xdebug
• Changelog
• Users and permissions
• Crond
• SSHD
• Adding SSH key
• Complete PHP-based stack
• Images based on wodby/php
• Orchestration Actions

Docker Images

❗For better reliability we release images with stability tags (wodby/php:8-X.X.X) which correspond to git tags. We strongly recommend using images only with stability tags.

About images:

• All images based on Alpine Linux
• Base image: official php
• GitHub actions builds
• Docker Hub

Supported tags and respective Dockerfile links:

• 8.3, 8, latest (8/Dockerfile)
• 8.2 (8/Dockerfile)
• 8.1 (8/Dockerfile)
• 8.3-dev, 8-dev, dev (8/Dockerfile)
• 8.2-dev (8/Dockerfile)
• 8.1-dev (8/Dockerfile)
• 8.3-dev-macos, 8-dev-macos, dev-macos (8/Dockerfile)
• 8.2-dev-macos (8/Dockerfile)
• 8.1-dev-macos (8/Dockerfile)

-dev

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
• Additional packages installed: yarn

-dev-macos

Same as -dev but the default user/group wodby has uid/gid 501/20 to match the macOS default user/group ids.

Supported architectures

All images built for linux/amd64 and linux/arm64

Environment Variables

PHP and PHP-FPM configuration

The default configuration not recommended for use for production environment:

"-" - Not available for this version

Additional configuration

Build arguments

Change WODBY_USER_ID and WODBY_GROUP_ID mainly for local dev version of images, if it matches with existing system user/group ids the latter will be deleted.

PHP Extensions

Extensions xdebug, xhprof and spx disabled by default, to change it override the default env var PHP_EXTENSIONS_DISABLE=xdebug,xhprof,spx.

Legend:

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

• sqlsrv extension has no arm64 support because the driver has no support for linux/arm64

Tools

Xdebug

By default, xdebug mode set to off, which has close to 0 overhead. If you want to disable the extension completely set PHP_EXTENSIONS_DISABLE=xdebug.

Changelog

Changes per stability tag reflected in git tags description under releases.

Crond

You can run Crond with this image changing the command to sudo -E crond -f -d 0 and mounting a crontab file to ./crontab:/etc/crontabs/www-data. Example crontab file contents:

# min   hour    day month   weekday command
*/1 *   *   *   *   echo "test" > /mnt/files/cron

SSHD

You can run SSHD with this image by changing the command to sudo /usr/sbin/sshd -De and mounting authorized public keys to /home/wodby/.ssh/authorized_keys

Adding SSH key

You can add a private SSH key to the container by mounting it to /home/wodby/.ssh/id_rsa

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.

See https://github.com/wodby/php/issues/22 for more details.

Helper scripts

• files_chmod – 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 ug=rwX,o=rX

• files_chown – in case you manually uploaded files under wodby user to files volume and want to change the ownership of those files to www-data run sudo files_chown [FILEPATH] script (FILEPATH must be under /mnt/files), it will recursively change ownership to www-data:www-data

Complete PHP-based stacks

• wodby/docker4php
• wodby/docker4laravel
• wodby/docker4drupal
• wodby/docker4wordpress

Images based on wodby/php

• wodby/drupal-php
• wodby/wordpress-php
• wodby/adminer
• wodby/matomo
• wodby/cachet
• wodby/webgrind
• wodby/xhprof

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