Skip to content

feat: add PHP 8.6 support - #257

Open
todeveni wants to merge 1 commit into
lando:mainfrom
todeveni:php86
Open

todeveni wants to merge 1 commit into
lando:mainfrom
todeveni:php86

Conversation

@todeveni

@todeveni todeveni commented Nov 19, 2026 •

Copy link
Copy Markdown

Adds PHP 8.6 support.

Changes

  • New images/8.6-apache and images/8.6-fpm images based on php:8.6-*-trixie, added to the image build workflow
  • New examples/8.6 Leia tests, added to the PR test matrix
  • 8.6 added to supported versions and docs (docs/index.md, extensions table in docs/extensions.md)

Extensions

No PECL release of apcu, memcached, redis or oauth compiles against PHP 8.6 yet, so the 8.6 images build them from pinned upstream commits:

Extension Source
apcu krakjoe/apcu@fb2c942
redis phpredis/phpredis@5b60b12 (lzf, zstd, lz4)
memcached php-memcached-dev/php-memcached@0b52d36 (session, json, sasl)
oauth php/pecl-web_services-oauth@f524860

apcu, redis and memcached are built with plain phpize, as install-php-extensions passes configure flags these unreleased versions don't handle. These should go back to the regular install-php-extensions lines once PECL releases support 8.6.

imap is not included in the 8.6 images. It has been unmaintained since 2024 and does not compile against PHP 8.6 (neither the PECL release nor main).

MySQL clients

The 8.6 images ship MySQL 8.4 and 9.7 (LTS) clients, not the EOL 8.0 client. scripts/mysql-client-install.sh now maps mysql:9.x to the 9.7 client and falls back to the 8.4 client when the requested client isn't present in the image. On 8.6, mysql:8.0 and mysql:5.7 therefore get the 8.4 client and not MariaDB's. Older images still ship 8.0, so they behave as before.

Testing

Built both images locally (arm64) and ran examples/8.6 with Leia: 28 passing. The 8.6 Leia job in CI will fail until the devwithlando/php:8.6-* images have been built and pushed.

Bare minimum self-checks

  • I've updated this PR with the latest code from main
  • I've done a cursory QA pass of my code locally
  • I've ensured all automated status check and tests pass
  • I've connected this PR to an issue

Pieces of flare

  • I've written a unit or functional test for my code
  • I've updated relevant documentation it my code changes it
  • I've updated this repo's README if my code changes it
  • I've updated this repo's CHANGELOG with my change unless its a trivial change (like updating a typo in the docs)

Finally

🤖 Generated with Claude Code

@netlify

netlify Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

👷 Deploy request for lando-php pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 9290f7b

Add PHP 8.6 images, example and docs. apcu, memcached and redis are built
from pinned upstream commits until PECL releases support 8.6, and imap is
omitted as it does not compile against 8.6. The 8.6 images ship MySQL 8.4
and 9.7 clients and the client install script now falls back to 8.4 when
the requested client is not in the image.
@todeveni
todeveni marked this pull request as ready for review November 19, 2026 17:17
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