Docker-Laravel-Redis-Postgres-Nginx
Simple docker env, for local development.
About build:
composer (Dockerfile, project-init and start-entrypoint scripts)
load clean laravel project blade template if not exists in ./app, or update vendor
app (Dockerfile and start-entrypoint)
run after pre-build stage, create laravel-fpm container and serve by php-fpm (load www.conf, and php.ini from ./php)
- cache (redis-alpine)
web (nginx-alpine)
edit default.config.template in ./nginx/templates/
adm (adminer)
works with mysql, postgres etc (change driver before login)
- db (postgres:alpine)
example ‘.env’ config for build
.env holds all build env every service (overrites laravel .env file)
Pre-build stage
Before run you should install docker on your PC.
How install docker, official docs
Checkout docker already installed, just run in terminal and you get docker version info
docker -v
Run composer service before and load laravel project source (build composer image and load empty laravel project)
docker compose up -d composer
Add vite server (serve all resource stuff styles & scripts) into app/vite.config.js
if no permissions for edit file change owner (default owner - www)
sudo chown <your_user> app/vite.config.js
Show all default config file
import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';
import tailwindcss from '@tailwindcss/vite';
// combine all vite environment variables and default values
const vite = {
'host': process.env.VITE_HOST ?? '0.0.0.0',
'port': process.env.VITE_PORT ?? 5173,
'appPort': process.env.APP_PORT ?? 8000,
'appUrl': process.env.APP_URL ?? 'localhost',
'base': process.env.VITE_BASE ?? '/app/',
};
export default defineConfig({
plugins: [
laravel({
input: ['resources/css/app.css', 'resources/js/app.js'],
refresh: true,
}),
tailwindcss(),
],
// add this vite server section
server: {
// respond to all network requests
host: vite.host,
port: vite.port,
base: vite.base,
strictPort: true,
// all outside requests to port 5173 pass throw artisan server to nginx
proxy:{
'^(?!(\/\@vite|\/resources|\/node_modules))': {
target: `http://${vite.appUrl}:${vite.appPort}`,
}
},
hmr: {'host':vite.appUrl, 'port':vite.port},
// Defines the origin of the generated asset URLs during development,
// this will also be used for the public/hot file (Vite devserver URL)
cors: {
origin: [
`http://${vite.appUrl}:8000`, // dev server cors
`http://${vite.appUrl}:80`,
`http://${vite.appUrl}`,
]
},
}
});
Then remove composer service final pre-build stage
docker compose down --remove-orphans
Workflow
Run docker compose up
docker compose up -d
And now checkout in browser:
Adminer if want edit database manually
Nginx proxy for services (laravel-app)
Laravel official framework info
Laravel access on default port nginx, but serve by php-fpm server, settings edit in www.conf in ./php
Permission problem
You can add root access for your user (host machine)
alpine www-data user assign to 82 id, so create new user with same name group with same id on your host machine (example for ubuntu)
sudo groupadd -g 82 www
sudo useradd -u 82 -g 82 www
Now add your current user (host machine) into www group for full permission
sudo usermod -a -G www [user-name]
Add full permission for your user, use command as root (sudo) -R flag (recursive run)
sudo chown -R [user-name]:www /path/to/your/local/folder
How return default permission
This will return all back, use command as root (sudo) -R flag (recursive run)
sudo chown -R www /path/to/your/local/folder
Help tools
- Gitignore generator helps generate gitignore for your lang, ide, or framework.
Описание
Docker environment: composer (load init laravel or update), laravel-fpm, redis, postgres, nginx, adminer.