Infrastructure: Upgrade Docker images to Ubuntu 22.04 + PHP 8.2 toolchain

[PurHur]

Problem

README/Makefile center on Ubuntu 16.04 and PHP 7.4. Docker/ubuntu-18.04 exists but README says 18.04 is "not working (yet)" due to FFIMe/glibc.

Goal

Reproducible make test on maintained base image.

Tasks

• Fix or replace FFIMe/preprocessor for newer glibc
• PHP 8.2 build with FFI in dev image
• Bundle or pin LLVM 9/14 consistently with PHPLLVM\Chooser
• Update CircleCI / new GHA to use new image
• Deprecation timeline for 16.04 image

Acceptance criteria

make test passes on 22.04-dev image without manual patches.

Related

• CI: Add GitHub Actions workflow for PHPUnit (VM, compliance, real, AOT) #47 CI GitHub Actions
• DevEx: Document and stabilize host-based workflow (ci-local.sh, LLVM 9) #46 Host-based workflow docs

[PurHur]

Status update — partial overlap with #202 / #237 (2026-05-19)

Docker/dev/ubuntu-22.04/Dockerfile exists with PHP 8.2 + extensions; make docker-build-22 / make test-docker are in the Makefile; README documents container workflow.

Remaining for this issue:

• FFIMe / preprocessor on newer glibc (if still required for any target)
• make test (legacy 16.04) vs make test-docker (22.04) clarity
• Deprecation timeline for 16.04/18.04 images

Split:

• Infrastructure: Publish Docker dev image and document container CI workflow #202 — publish ghcr.io/PurHur/php-compiler:dev + docs
• Infrastructure: Pre-install LLVM 9 in 22.04 dev Docker image for JIT/AOT CI #237 — bake LLVM 9 into the 22.04 image so JIT/AOT tests run in container CI

Consider closing #73 when make test-docker + ./script/ci-local.sh pass without manual patches; track publish/LLVM in #202/#237.

[PurHur]

Status update (backlog architect)

Partially delivered — narrow remaining scope:

Done on master

• Docker/dev/ubuntu-22.04/Dockerfile — PHP 8.2 + extensions, LLVM 9 at /opt/llvm9 (Infrastructure: Pre-install LLVM 9 in 22.04 dev Docker image for JIT/AOT CI #237 closed)
• make docker-build-22, make test-docker, LOCAL_DEV_IMAGE=php-compiler:22.04-dev
• README “Container development” section

Still open (track here or #202)

• Default make test still targets 16.04 image — migrate default to 22.04-dev or document deprecation
• Fix/replace legacy ircmaxell/php-compiler:16.04-dev pull (404) — Infrastructure: Publish Docker dev image and document container CI workflow #202 publish
• CircleCI badge vs PurHur GHA — docs only

Do not apt-install PHP/LLVM on Runforge harness — use make test-docker / ./script/docker-ci-local.sh.

Closing criteria for #73: make test-docker green on fresh clone + README no longer implies 16.04 as primary path.

[PurHur]

De-duplication (backlog architect — batch 8)

Most 22.04 work landed in Docker/dev/ubuntu-22.04/ + #237. Remaining items tracked elsewhere:

• DevEx: Makefile — default test target uses 22.04 Docker (deprecate 16.04) #249 — make test defaults to test-docker
• Infrastructure: Publish Docker dev image and document container CI workflow #202 — GHCR publish + pull docs
• Docs: Local CI matrix (host, Docker, GHA skips) in README #245 — CI matrix documentation

Suggest closing #73 when README/Makefile no longer present 16.04 as the primary make test path and make test-docker is green on fresh clone. Keep FFIMe/glibc notes here until legacy targets are removed.

[PurHur]

Backlog de-dupe (batch 9): Most of this issue is done on master:

• ✅ Docker/dev/ubuntu-22.04/ + PHP 8.2 + make test-docker (Infrastructure: Pre-install LLVM 9 in 22.04 dev Docker image for JIT/AOT CI #237 LLVM in image)
• ✅ script/ci-local.sh runs full suite in container

Remaining scope (track elsewhere):

Work	Canonical issue
Default make test → 22.04 Docker	#249
Publish/pull ghcr.io/.../dev	#202
Local CI matrix docs	#245

Verification (local): make docker-build-22 && make test-docker — no GHA required.

Recommend closing #73 when #249 lands; keep #202 for registry publish only.

[PurHur]

De-dupe (ROADMAP batch 10)

Canonical: Docker/dev/ubuntu-22.04/Dockerfile (#237 ✅), make test-docker / script/docker-ci-local.sh, #249 (make test default → 22.04).

This issue’s original scope (22.04 + PHP 8.2 + LLVM) is implemented in-tree. Remaining work is Makefile default (#249) and publishing/docs (#202).

Do not reopen 16.04 paths for new work. Close this issue when #249 lands, or now if maintainers agree the image work is done.

Local verification only:

make docker-build-22 && make test-docker

[PurHur]

Close recommendation (backlog architect — batch 11)

Status: implemented. Docker/dev/ubuntu-22.04/Dockerfile, make docker-build-22, make test-docker, LLVM at /opt/llvm9 (#237 ✅).

Remaining work is not “upgrade Docker”:

Item	Issue
make test → 22.04 default	#249
GHCR publish + pull docs	#202
CI matrix documentation	#245

Recommend closing #73 and tracking the Makefile default in #249 only. FFIMe/16.04 legacy targets can be noted in #249 deprecation comment.

Verify locally: make docker-build-22 && make test-docker