New features​

PHP 8.4 images​

The newest PHP line is now available:

docker pull himanshuramavat/php-ci:8.4

Add a "future PHP" column to your matrix to catch deprecations before they become breaking changes:

strategy:
  matrix:
    php: ['8.1', '8.2', '8.3', '8.4']
container:
  image: himanshuramavat/php-ci:${{ matrix.php }}

GitHub Container Registry mirror​

Every tag is now also published to GHCR, which avoids Docker Hub pull-rate limits on shared CI runners:

docker pull ghcr.io/himanshuramavat/php-ci:8.3

Both registries carry identical tags and digests — pick whichever suits your runner. See the Docker Tags reference.

More extensions​

The image ships the extensions commonly needed in CI runs (database drivers, intl/string handling, image processing, etc.). See the PHP Extensions page for the current list.

Changes​

• Rolling tags are rebuilt regularly to pick up upstream PHP and base-OS security patches.
• Composer is included in the image for CI usage.

Fixes​

• Fixed an intl ICU data mismatch that affected locale-sensitive tests.

Upgrade notes​

• Pin a concrete PHP tag (:8.3, :8.4, etc.) for reproducible pipelines.
• TYPO3 functional tests can run on SQLite via pdo_sqlite; MySQL users should confirm the mysql:8.0 service image still matches their expectations.

Full changelog​

See the complete Changelog for every entry, and the GitHub release for the tagged artefacts.

Thanks to everyone who reported issues and tested the 8.4 images during the pre-release. As always, feedback is welcome on GitHub.

What it is​

php-ci is a reusable Docker image for CI/CD pipelines. It bundles PHP 8.1–8.4, Composer 2, and the extensions and system libraries commonly needed for CI. Install your project-level test/QA tooling via Composer (./vendor/bin/*). Point your pipeline at one image tag and your config collapses to a few lines:

jobs:
  test:
    runs-on: ubuntu-latest
    container:
      image: himanshuramavat/php-ci:8.3
    steps:
      - uses: actions/checkout@v4
      - run: composer install --no-interaction --no-progress
      - run: ./vendor/bin/phpunit

Why we built it​

Three problems kept coming up across TYPO3, Laravel and library projects:

1. Duplication. Every repo carried its own provisioning steps that drifted over time.
2. Slow cold starts. Installing extensions on every job wasted minutes.
3. Non-reproducibility. "Works on my pipeline" because the runner happened to have the right PHP patch.

A version-pinned image solves all three: one place to maintain, extensions baked in, identical bytes everywhere.

Goals for the project​

• Stay small and predictable. A tight, well-documented tag convention — no surprise breaking changes.
• Be provider-agnostic. The same image works on GitHub Actions, GitLab CI and Bitbucket Pipelines.
• Track PHP closely. New PHP minor lines land as new tags so you can test forward compatibility early.
• Document everything. That's what this site is for.

Get started​

• Read the Introduction and Quick Start.
• Grab a copy-paste pipeline for GitHub Actions, GitLab CI or Bitbucket Pipelines.
• Star the repo on GitHub and pull the image from Docker Hub.

Feedback and contributions are very welcome — see the Contributing guide. Happy shipping!