Skip to content

Upgrade base image to Debian Bookworm and document PHP extensions - #29

Merged
f3l1x merged 3 commits into
masterfrom
claude/php-bookworm-upgrade-tq8o9r
Sep 8, 2026
Merged

Upgrade base image to Debian Bookworm and document PHP extensions#29
f3l1x merged 3 commits into
masterfrom
claude/php-bookworm-upgrade-tq8o9r

Conversation

@f3l1x

@f3l1x f3l1x commented Sep 7, 2026

Copy link
Copy Markdown
Member

Summary

This PR upgrades all Docker images from Debian Bullseye to Bookworm as the base image, and significantly improves the documentation of PHP extensions with a comprehensive compatibility matrix.

Key Changes

  • Base Image Upgrade: Updated all 24 Dockerfiles (PHP 5.6 through 8.5, both standard and FPM variants) to use dockette/debian:bookworm instead of bullseye
  • PHP Extensions Documentation: Replaced the inline text listing of PHP extensions with a detailed compatibility table showing:
    • All 25 PHP extensions across 12 PHP versions (5.6 through 8.5)
    • Clear visual indicators (✅/❌) for extension availability per PHP version
    • Notable version-specific removals documented (e.g., mcrypt removed in 7.2+, imagick removed in 7.2+, geoip removed in 8.0+)
    • Added clarification about SAPIs (cli, cgi, phpdbg) and FPM availability

Notable Implementation Details

  • The compatibility matrix provides transparency on which extensions are available in each PHP version, making it easier for users to understand version-specific limitations
  • The upgrade to Bookworm (Debian 12) provides a more current base image with updated system packages and security patches

https://claude.ai/code/session_01Bi3iVf389XhA112qsqJg4r

Change the base image from dockette/debian:bullseye to
dockette/debian:bookworm for the CLI and FPM images of PHP 8.2, 8.3,
8.4 and 8.5. The sury repository line uses lsb_release -sc, thus it
points to the bookworm suite without more changes.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Bi3iVf389XhA112qsqJg4r
Change the base image from dockette/debian:bullseye to
dockette/debian:bookworm for PHP 5.6 - 8.1, CLI and FPM. All 24 images
now use the same base.

The sury bullseye suite stopped serving these packages, thus the
bullseye builds fail with apt exit code 100.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Bi3iVf389XhA112qsqJg4r
Replace the prose list with a table of extension against PHP version.
The table content comes from the Dockerfiles. Move the cli, cgi, phpdbg
and fpm SAPIs into a note, because they are not extensions.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Bi3iVf389XhA112qsqJg4r
@f3l1x
f3l1x merged commit 5f2ce9e into master Sep 8, 2026
27 checks passed
@f3l1x
f3l1x deleted the claude/php-bookworm-upgrade-tq8o9r branch September 8, 2026 11:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants