madlabcg/laravel-php repository overview

⁠laravel-php

Production runtime for Laravel applications: PHP-FPM + nginx + supervisor on Alpine Linux, ready to run the web server, queue workers and the scheduler from a single container.

The image contains no application code and no secrets. Your app's Dockerfile starts FROM it and only adds dependencies, compiled assets and source code, so builds take seconds instead of minutes.

• Platforms: linux/amd64, linux/arm64
• Listens on port 8080
• App directory: /var/www/html (docroot /var/www/html/public)

⁠Tags

Tags follow <exact runtime version>-r<revision>:

The revision (-r1, -r2, …) increases when the image is rebuilt without a PHP change (Alpine security patches, a new extension, config changes) and resets to -r1 with every new PHP release.

⁠PHP lines

One line per PHP version, all with the same contents. Pick the one your app needs.

⁠What's inside

Not included: Node.js, git and compilers. Build your frontend assets in a separate stage.

⁠Quick start

# syntax=docker/dockerfile:1
ARG BASE_IMAGE=madlabcg/laravel-php:8.4.26-r1

# PHP dependencies
FROM ${BASE_IMAGE} AS vendor
COPY composer.json composer.lock ./
RUN composer install --no-interaction --no-scripts --no-autoloader --prefer-dist

# Frontend assets (architecture independent, always built natively)
FROM --platform=$BUILDPLATFORM node:22-alpine AS assets
WORKDIR /var/www/html
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
COPY --from=vendor /var/www/html/vendor ./vendor
RUN npm run build

# Application
FROM ${BASE_IMAGE}
ARG GIT_COMMIT=unknown
COPY --from=vendor --chown=www-data:www-data /var/www/html/vendor ./vendor
COPY --chown=www-data:www-data . .
COPY --from=assets --chown=www-data:www-data /var/www/html/public/build ./public/build
RUN composer dump-autoload --optimize --classmap-authoritative \
    && echo "${GIT_COMMIT}" > /.git-commit \
    && date -u +%Y%m%d-%H%M%S > /.build-date

Add a .dockerignore that excludes at least .git, .env*, node_modules, vendor, public/build and storage/* runtime files.

Run it:

docker run -d -p 8080:8080 \
  -e APP_KEY=base64:... \
  -e DB_CONNECTION=pgsql -e DB_HOST=db -e DB_DATABASE=app -e DB_USERNAME=app -e DB_PASSWORD=secret \
  -e RUN_MIGRATIONS=true -e FORCE_MIGRATIONS=true \
  my-laravel-app

⁠Startup sequence

On every container start madlab-entrypoint:

1. Waits for the database (a server that answers "database does not exist" counts as ready).
2. Creates the storage/ and bootstrap/cache directories, clears compiled views and fixes permissions for www-data.
3. Requires APP_KEY, runs storage:link and checks public/build/manifest.json.
4. Runs a fresh install or migrations when requested.
5. Runs php artisan optimize when APP_ENV=production.
6. Runs every /docker-entrypoint-init.d/*.sh in alphabetical order.
7. Starts the CMD (supervisor by default).

⁠Environment variables

Boolean flags accept true, 1 or yes, tolerating quotes, spaces and inline # comments.

⁠Customizing

⁠Healthcheck

The image defines a HEALTHCHECK that verifies php-fpm and nginx are running and that the app answers below HTTP 500. In Compose:

healthcheck:
  test: ["CMD", "/usr/local/bin/madlab-healthcheck"]
  interval: 30s
  timeout: 10s
  retries: 3
  start_period: 90s