PHP 8.2–8.5, Node.js 24 LTS and Composer 2 on Alpine, with PHP QA tools, for CI and local dev
10K+
A ready-to-go image for building and testing PHP / Laravel apps in CI (GitLab CI, GitHub Actions, Bitbucket, …) and locally. PHP, Composer, Node.js, npm, Yarn and the usual QA tools are already installed, so jobs can start on composer install instead of on setup.
Built on the official php:<version>-fpm-alpine image, for linux/amd64 and linux/arm64.
docker run --rm -it -v "$PWD":/app -w /app msonowal/docker-php-node:php85 sh
Also published to GitHub Container Registry:
docker pull ghcr.io/msonowal/docker-php-node:php85
image: msonowal/docker-php-node:php85
test:
script:
- composer install --no-interaction --prefer-dist
- npm ci && npm run build
- vendor/bin/phpunit
jobs:
test:
runs-on: ubuntu-latest
container: ghcr.io/msonowal/docker-php-node:php85
steps:
- uses: actions/checkout@v7
- run: composer install --no-interaction --prefer-dist
- run: npm ci && npm run build
- run: vendor/bin/phpunit
| Tag | PHP | Upstream PHP status |
|---|---|---|
php85, latest, edge, main | 8.5 | Active support |
php85-cloud, latest-cloud | 8.5 | Same, plus deploy and infrastructure CLIs (see Cloud tags) |
php84 | 8.4 | Active support |
php83 | 8.3 | Security fixes only |
php82 | 8.2 | Security fixes only (until Dec 2026) |
php81 | 8.1 | End of life, image no longer rebuilt |
php8, php80 | 8.0 | End of life, image no longer rebuilt |
php74, php73, php72, php71 | 7.x | End of life, image no longer rebuilt |
php82 to php85 are all built from main and rebuilt every week, to pick up base image and package security fixes. nightly and nightly-cloud point at the latest weekly build of php85. Pin a phpXY tag in CI rather than latest, so a new PHP release doesn't change your build without warning.
php85 builds are also tagged sha-<commit>. Browse all tags on Docker Hub or GHCR.
php82 to php85 all ship this set. Each Composer tool is the newest release that supports the tag's PHP version. The frozen php81 and older tags still ship Yarn 1 without Corepack, the original phpcpd and local-php-security-checker, and no Xdebug or PostgreSQL support.
PHP with the development php.ini, plus these extensions on top of the official image's defaults:
bcmath exif gd gmp intl mongodb opcache pcntl pcov pdo_mysql pdo_pgsql pgsql redis sockets zip, and Xdebug (installed, off by default)
JavaScript: Node.js 24 LTS (from Alpine's packages), npm, and Corepack for Yarn and pnpm. See Yarn and pnpm.
Composer 2, plus these tools on PATH. Each is installed in its own directory under /opt/tools, so their dependencies can't conflict.
| Tool | Command |
|---|---|
| PHPUnit | phpunit |
| phpcov | phpcov |
| PHPStan | phpstan |
| Laravel Pint | pint |
| PHP CS Fixer | php-cs-fixer |
| PHP_CodeSniffer | phpcs, phpcbf |
| PHPMD | phpmd |
| phpcpd (maintained fork) | phpcpd |
| composer-normalize | composer normalize |
| composer-unused | composer-unused |
| ComposerRequireChecker | composer-require-checker |
composer audit | security-checker (see below) |
| Laravel Envoy | envoy |
| Laravel Vapor CLI | vapor |
| Laravel installer | laravel |
| Laravel Cloud CLI (PHP 8.4 and newer) | cloud |
Also: AWS CLI v2, GitHub CLI (gh), GitLab CLI (glab), MariaDB / MySQL client, PostgreSQL 18 client, git, openssh-client, curl, bash, jq, yq, envsubst, rsync, make, patch, zstd, tzdata, zip / unzip
Code coverage uses pcov. Xdebug is installed but not loaded. Turn it on for a single command with php -dzend_extension=xdebug, or for a whole job (as root) with:
echo "zend_extension=xdebug" > "$PHP_INI_DIR/conf.d/xdebug.ini"
security-checker now runs composer audit --locked, because local-php-security-checker is archived. It still accepts the old --path, --format=json, --no-dev and --disable-exit-code options, and exits non-zero when composer.lock has a package with a known advisory.
yarn and pnpm come from Corepack, which uses whatever version the project pins in package.json:
{ "packageManager": "[email protected]" }
/opt/corepack. If such a job needs a version that isn't pre-installed, set COREPACK_HOME=$HOME/.cache/corepack.Yarn 4 keeps its cache outside the project by default. GitLab CI can only cache paths inside the project, so point both Yarn versions at one folder there:
variables:
YARN_ENABLE_GLOBAL_CACHE: "false" # Yarn 4: use YARN_CACHE_FOLDER
YARN_CACHE_FOLDER: .yarn-cache # Yarn 1 and Yarn 4
cache:
paths:
- .yarn-cache
php85-cloud and latest-cloud are the same image plus these CLIs, for deploy and infrastructure jobs. They are about 1 GB larger uncompressed, so use them only in the jobs that need them.
| Tool | Command |
|---|---|
| Docker CLI with buildx and compose | docker |
| kubectl | kubectl |
| Helm 4 | helm |
| OpenTofu | tofu |
| Terraform | terraform |
| Google Cloud CLI with the GKE auth plugin | gcloud |
| Firebase CLI | firebase |
docker:dind service and set DOCKER_HOST.bq and gsutil; use gcloud storage instead of gsutil.GOOGLE_APPLICATION_CREDENTIALS, or with workload identity federation.Bref belongs in your project, not in the image. Add bref/bref to composer.json, then deploy with osls, the open-source Serverless Framework fork that Bref recommends:
npm install --save-dev osls
npx osls deploy
serverless.yml pins frameworkVersion: '3'. Projects that still pin v3 should install osls@legacy instead.Every tag built from main (php82 to php85, latest and the -cloud tags) is signed with cosign keyless signing, and carry SBOM and SLSA provenance attestations.
cosign verify ghcr.io/msonowal/docker-php-node:php85 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
--certificate-identity https://github.com/msonowal/docker-php-node/.github/workflows/docker-image.yml@refs/heads/main
docker buildx imagetools inspect ghcr.io/msonowal/docker-php-node:php85 --format '{{ json .SBOM }}'
docker build -t docker-php-node .
# another PHP version, or the -cloud variant
docker build --build-arg PHP_VERSION=8.3 -t docker-php-node:php83 .
docker build --target cloud -t docker-php-node:cloud .
# the smoke test CI runs in every image
docker run --rm -v "$PWD/tests:/tests:ro" docker-php-node:php83 sh /tests/smoke.sh 8.3
CI builds every PHP version for linux/amd64 and linux/arm64, each natively on its own GitHub-hosted runner, then merges them into multi-arch tags. See .github/workflows/docker-image.yml.
Every run also does the following:
tests/smoke.sh in each image before pushing it. The test checks the PHP version, extensions and every tool, then installs and tests a small project with Composer, PHPUnit and npm.Pull requests build and test every image without publishing anything. Images are published only from main.
Renovate keeps the pinned versions up to date. It merges minor and patch updates once CI passes, and leaves major updates for review. Planned work is in docs/ROADMAP.md.
Content type
Image
Digest
sha256:9c4f9a374…
Size
297.6 MB
Last updated
about 16 hours ago
docker pull msonowal/docker-php-node