Skip to content

Add PHP 8.6 images for WordPress 7.2+ - #1028

Open
desrosj wants to merge 4 commits into
docker-library:masterfrom
desrosj:php-8.6-beta
Open

desrosj wants to merge 4 commits into
docker-library:masterfrom
desrosj:php-8.6-beta

Conversation

@desrosj

@desrosj desrosj commented Nov 5, 2026 •

Copy link
Copy Markdown

WordPress 7.2 (currently in beta) adds support for PHP 8.6. This PR adds PHP 8.6 variants so the ecosystem can test against them during the 7.2 pre-release cycle. In #986 there was some interest in exploring PHP pre-release support "assuming WordPress upstream supports the given pre-release version", and that's the case here.

Changes

Rendered output for PHP 8.2–8.5 and cli is byte-identical to what's currently committed.

Notes

Still to do (why this is a draft)

  • Run ./apply-templates.sh and commit the generated beta/php8.6/* directories
  • Build and smoke-test apache, fpm and fpm-alpine on 8.6

AI Disclaimer

This PR was generated with Claude Opus 5.5 and manually reviewed by me.

WordPress 7.2 adds support for PHP 8.6, so the pre-release ("beta") images
now include PHP 8.6 variants built from the upstream `php:8.6-rc-*` images.
The `latest` and `cli` channels are unchanged.

PHP 8.6 images no longer ship pear/pecl or a compiled-in mbstring
(docker-library/php#1654), so for 8.6:
- mbstring is installed via docker-php-ext-install
- imagick is built from the checksum-verified PECL source tarball via
  docker-php-ext-install instead of `pecl install`

Note: the generated beta/php8.6/* Dockerfiles have not been produced yet
(run ./apply-templates.sh beta).
Gate PHP 8.6 on the WordPress version rather than the release channel, so
any 7.1.x release (including a 7.1.x point release or RC that lands in the
"latest" or "beta" channel) never receives PHP 8.6 images, while 7.2
pre-releases and the 7.2 release itself (and later) do.
No imagick release compiles against PHP 8.6: 3.8.1 still uses zval_dtor()
and XtOffsetOf(), both removed in PHP 8.6 (see php-src UPGRADING.INTERNALS).
The XtOffsetOf fix (Imagick/imagick#795) is merged but unreleased, and the
zval_dtor fix (Imagick/imagick#768) is still open. Installing imagick
without pecl is also pending docker-library#1001 (pie).

Until then, PHP 8.6 images skip imagick and its build-only -dev packages;
WordPress falls back to GD for image processing. The PHP 8.2-8.5 output
is unchanged.
@desrosj
desrosj marked this pull request as ready for review November 5, 2026 01:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant