Skip to content

Automatically create Docker images for your Laravel application

License

Notifications You must be signed in to change notification settings

blamebutton/laravel-docker-builder

Repository files navigation

Banner

Packagist Version Packagist Downloads GitHub Workflow Status

Features

  • Build Docker images using the Artisan CLI
  • Detect PHP version and extensions
  • Bundle assets with Vite.js or Laravel Mix
  • Separate NGINX and PHP-FPM images
  • Deployment examples for Kubernetes and Docker Compose

Installation

composer require --dev blamebutton/laravel-docker-builder

Usage

Detect Configuration

php artisan docker:generate --detect

When --detect is passed to the docker:generate command, it will automatically detect the following requirements:

  • PHP version, detected using the php version in your composer.json
  • PHP extensions, detected using the configuration of your project:
    • Cache driver: Redis, Memcached, APC
    • Database driver: MySQL, Postgres, SQL Server
    • Broadcasting driver: Redis
    • Queue driver: Redis
    • Session driver: Redis, Memcached, APC
  • Node package manager, detected using the existence of package-lock.json or yarn.lock
  • Node build tool, detected using the existence of vite.config.js or webpack.mix.js

Manual Configuration

php artisan docker:generate

When no options are passed to docker:generate, a prompt is used to configure the project's requirements.

See all available options, and their supported values, by running php artisan docker:generate --help.

  • -p, --php-version - PHP version for Docker image
  • -e, --php-extensions - PHP extensions (comma-separated) to include in Docker image
  • -o, --optimize - Run php artisan optimize on container start
  • -a, --alpine - Use Alpine Linux based images
  • -m, --node-package-manager - Install Node dependencies using NPM or Yarn
  • -b, --node-build-tool - Run Vite.js or Laravel Mix build step

Configuration

Option 1: Config File

php artisan vendor:publish --provider="BlameButton\LaravelDockerBuilder\DockerServiceProvider"

Option 2: .env

By default, the configuration file reads the following environment variables to determine the Docker image tags.

DOCKER_NGINX_TAG=laravel-app:nginx
DOCKER_PHP_TAG=laravel-app:php