jamesmorrison/php repository overview

⁠PHP Docker Images

Ubuntu-based PHP runtime images for web applications and command-line tasks.

Image: jamesmorrison/php

⁠Versions and platforms

PHP versions: 8.2, 8.3, 8.4 and 8.5.

Platforms: linux/amd64 and linux/arm64.

Version tags follow the format jamesmorrison/php:<version> and track the installed patch release at build time. Test tags use <version>-test-<commit-sha>.

⁠Runtime defaults

The image provides PHP-FPM, not an HTTP server. Application files and writable directories must have permissions suitable for www-data.

⁠Extensions and tools

PHP extensions include BCMath, cURL, GD, Imagick, Intl, Mbstring, Memcache, Memcached, MySQL, OPcache, Redis, SOAP, XML, XML-RPC and ZIP.

Tools include PHP CLI, Composer, WP-CLI, ImageMagick, msmtp, cURL, rsync, wget and unzip.

Xdebug and development tooling are not included.

Datadog PHP tracing/profiling installation is best-effort and depends on compatibility with the selected PHP version. Runtime activation is opt-in.

⁠OPcache

OPcache caches compiled PHP bytecode, not application results or database data.

FPM benefits from bytecode caching while checking file timestamps on every request. CLI bytecode caching requires explicit activation.

PHP 8.2-8.4 use a separate OPcache package and module. PHP 8.5 includes OPcache in the PHP binary.

Shared configuration: /etc/php/<version>/mods-available/docker-opcache.ini.

⁠PHP-FPM

FPM error logs go to stderr, and worker output capture is enabled. Environment variables are available to FPM workers.

Pool configuration: /etc/php-fpm.d/.

⁠Mail and sessions

Mail is forwarded through msmtp using the /usr/sbin/sendmail compatibility link.

Session settings apply to FPM.

⁠Build arguments

⁠Health check

Checks that a PHP-FPM process exists and TCP port 9000 accepts connections.

The check covers process/listener availability, not application health.