Docker Laravel

🚫 Requirement

Docker engine 19.03.0+
Docker Compose 1.27+
Make

🛠 Build with

HTTP server Nginx 1.20
PHP 8.1
Node 16
Database PostgreSQL 14

📖 Install Laravel

Many commands are in Makefile file. Example start, stop, build and many more 👇.

It is not recommended to clone or fork the repository, download a copy of this Git repository
Run this command make laravel-install v=9 for install Laravel with Composer
⚠️ Modify environnement file .env create by Laravel installer with this :

DB_CONNECTION=pgsql
DB_HOST=pgsql
DB_PORT=5432
DB_DATABASE=Change this
DB_USERNAME=Change this
DB_PASSWORD=Change this

MAIL_MAILER=smtp
MAIL_HOST=mailhog
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=null
MAIL_FROM_NAME="${APP_NAME}"

Launch the environment with make start-dev
And enjoy 😊 !

🧰 Development environment

This command build container, install composer dependencies.

make install-dev

Start environment.

make start-dev

Development tools

Xdebug

For Visual Studio Code, use this configuration in .vscode/launch.json file.

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003,
            "pathMappings": {
                "/app": "${workspaceFolder}"
            }
        }
    ]
}

Mail capture

MailHog capture all mails form the application.

http://localhost:8025

💼 Production environment

First launch

Modify ⚠️ environnement file .env with production parameters
make install
make start

📚 List of commands

build : Build docker container
build-dev : Build docker development container
composer-install : Install PHP dependencies with Composer for production
composer-install-dev : Install PHP dependencies with Composer for devellopement
composer-update : Update PHP dependencies
database-migrate : Laravel database migration command
database-seed : Laravel database seeding command
down : Set in maintenance Laravel application
ide-helper : Generate helpers file for IDE (PHPStorm, VS Code ...)
git-pull : Reset stage and git pull
install : Run build, composer-install laravel-storage
install-dev : Run build-dev, composer-install-dev laravel-storage
laravel-install : Install Laravel with Composer
laravel-cache : Generate all cache for Laravel
laravel-storage : Create store link for Laravel
pull : Pull the lastest Docker containers
restart : Restart Docker containers
restart-dev : Restart Docker development containers
start : Start Docker containers
start-dev : Start Docker development containers
stop : Stop Docker containers
stop-dev : Stop Docker development containers
tinker : Run Laravel Tinker
test : Run Laravel unit test
test-create name=TestName : Create run Laravel unit test
up : Set online Laravel application
update : Run down git-pull composer-install laravel-cache database-migrate up
update-dev : Run down git-pull composer-install-dev database-migrate up
upgrade : Run stop git-pull pull build composer-install laravel-cache database-migrate start
upgrade-dev : Run stop git-pull pull-dev build-dev composer-install-dev database-migrate start

raviMukti/laravel-starter