jamesmorrison/php-dev repository overview

⁠PHP Development Docker Images

PHP development images extending jamesmorrison/php with debugging tools, Node.js and command-line utilities.

Image: jamesmorrison/php-dev

These images are intended for development, not production. All users have passwordless sudo access.

⁠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-dev:<version>. Test tags use <version>-test-<commit-sha>.

Each version builds on the matching jamesmorrison/php:<version> image.

⁠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

The image inherits PHP extensions, Composer, WP-CLI, ImageMagick, mail support and other runtime tools from the PHP image⁠.

Development additions include:

• Xdebug
• Git and Subversion
• MariaDB client
• Nano and Vim
• strace
• iproute2 and telnet
• sudo with passwordless access for all users
• nvm 0.40.1 and the Node.js LTS release selected at build time

nvm and Node.js are installed under the www-data home directory. nvm is shell-based; its environment must be loaded when needed in non-interactive shells.

⁠Xdebug

Xdebug is installed, but the default startup script disables it unless ENABLE_XDEBUG=true.

The value is case-insensitive. Only true enables Xdebug.

Enabling Xdebug loads the extension; debugging modes, client connection settings and triggers require separate Xdebug configuration.

Commands that bypass /entrypoint-dev.sh also bypass its Xdebug enable/disable handling.

⁠OPcache

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

The development image appends opcache.validate_timestamps=1 to the inherited configuration. It does not change the revalidation interval.

PHP 8.2-8.4 use a separate OPcache package and module. PHP 8.5 includes OPcache in the PHP binary. The development override works with both arrangements.

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

⁠PHP-FPM

FPM configuration is inherited from the PHP image.

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

The development startup script delegates to the PHP image startup script for mail and session configuration.

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

Session settings apply to FPM.

⁠Build arguments

Upload limits and other base-image settings are inherited. PHP_UPLOAD_LIMIT is configured when building the PHP base image, not this development image.

⁠Health check

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

The check covers process/listener availability, not application health. It expects the container to be running PHP-FPM rather than a standalone CLI command.