stsdockerhub/php repository overview

⁠PHP-FPM + Nginx for Laravel (Alpine & Debian)

Lightweight, production-ready PHP images for running Laravel (and other PHP applications) behind Nginx, in a single container. Alpine images are built on the official php:*-fpm-alpine images; the Debian (trixie) variant compiles PHP from source on debian:trixie-slim.

Source and docs: https://github.com/tgivslife/laravel-alpine⁠

⁠What's inside

PHP extensions include bcmath, curl, exif, gd, intl, mbstring, mysqli, pdo_mysql, pdo_pgsql, pdo_sqlite, pgsql, pcntl, redis, sockets, sodium, zip and Zend OPcache. Run php -m inside a container for the full list of a given tag.

⁠Runtime and build variants

Every runtime tag has a matching -build tag that adds a build toolchain: Composer, Node.js, npm and Git. Use -build to install dependencies and compile assets, and the slim runtime tag to run the result.

⁠Tags

Tag format:

• Alpine: <php version>-laravel-alpine<alpine version>[-build]
• Debian: <php version>-laravel-<debian codename>[-build]

Latest per PHP version:

Recent tags are multi-architecture (linux/amd64, linux/arm64): docker pull picks the right one. Older patch releases remain available on the Tags⁠ page; the exact package versions of each 8.5 Alpine release are listed in its GitHub release⁠.

PHP 8.2 and 7.4 are end-of-life upstream and kept for legacy applications only. They run the scheduler through cron and take a different set of environment variables than the ones below.

⁠Quick start: multi-stage Laravel image

ARG PHP_TAG=8.5.11-laravel-alpine3.24

FROM stsdockerhub/php:${PHP_TAG}-build AS build
WORKDIR /var/www/html
COPY . .
RUN composer install --no-dev --optimize-autoloader \
 && npm ci \
 && npm run build \
 && tar --owner=www-data --group=www-data \
        --exclude=.git --exclude=docker --exclude=node_modules -czf /tmp/app.tar.gz .

FROM stsdockerhub/php:${PHP_TAG}
WORKDIR /var/www/html
COPY --from=build /tmp/app.tar.gz .
RUN tar -xf app.tar.gz && rm app.tar.gz

# Optional: startup hooks (migrations, cache warm-up, …)
COPY docker/docker-entrypoint.d /docker-entrypoint.d/
RUN chmod +x /docker-entrypoint.d/*

docker build -t my-laravel-app .
docker run -p 8080:80 --env-file .env my-laravel-app

The application is then served at http://localhost:8080/⁠.

A complete sample application (Laravel + Vue starter kit, with scheduler and Horizon test jobs) is in example-app⁠.

⁠Environment variables

For PHP 8.3 and newer. All optional; defaults shown.

OS

Laravel

PHP

OPcache

PHP-FPM

Nginx

⁠Ports, paths and health check

The images (PHP 8.3 and newer) declare a Docker HEALTHCHECK that requests /ping through Nginx to PHP-FPM every 30 seconds, so the container turns unhealthy if either is down. /ping answers only requests from inside the container.

Each image is labelled with its version, git commit and build date: docker inspect -f '{{json .Config.Labels}}' stsdockerhub/php:<tag> (8.5 Alpine releases onward).

⁠Documentation

Build arguments and the full extension list of each image are in the version folders of the GitHub repository⁠; exact package versions are in the image README (manually published images) or the GitHub release⁠ (8.5 Alpine).