Docker Compose for PHP + PostgreSQL + RabbitMQ
A plain PHP setup gives complete control over your application with no framework overhead — ideal for learning Docker with PHP, running legacy codebases, or building lightweight applications with minimal dependencies.
PostgreSQL 15 is a powerful, ACID-compliant relational database with strong support for JSON, full-text search, and complex queries. Both Symfony (Doctrine) and Laravel (Eloquent) support PostgreSQL natively and it is increasingly preferred for new projects.
RabbitMQ is a reliable AMQP message broker for decoupling services and handling async workloads. Symfony Messenger and Laravel Queues both support RabbitMQ natively via the AMQP transport.
When should you use this stack?
PHP with PostgreSQL and RabbitMQ is a solid default for local development when your production environment matches it. If you're evaluating alternatives, the related configurations below swap one piece at a time — same framework with a different database, or the same data layer under a different framework — so you can compare without starting from scratch.
docker compose up -d
http://localhost:8080
compose.yml
services:
nginx:
image: nginx:latest
ports:
- "${WEB_PORT-8080}:80"
volumes:
- .:/var/www/html
- ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf:ro
depends_on:
- php
php:
image: php:8.5-fpm
volumes:
- .:/var/www/html
postgres:
image: postgres:15
environment:
POSTGRES_DB: ${POSTGRES_DB-app}
POSTGRES_USER: ${POSTGRES_USER-app}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD-secret}
ports:
- "${POSTGRES_PORT-5432}:5432"
volumes:
- postgres_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD", "pg_isready"]
interval: 10s
timeout: 5s
retries: 5
rabbitmq:
image: rabbitmq:3-management
environment:
RABBITMQ_DEFAULT_USER: ${RABBITMQ_DEFAULT_USER-app}
RABBITMQ_DEFAULT_PASS: ${RABBITMQ_DEFAULT_PASS-secret}
ports:
- "${RABBITMQ_PORT-5672}:5672"
- "${RABBITMQ_MANAGEMENT_PORT-15672}:15672"
healthcheck:
test: ["CMD", "rabbitmq-diagnostics", "check_port_connectivity"]
interval: 10s
timeout: 5s
retries: 5
volumes:
postgres_data:
docker/nginx/default.conf
Run mkdir -p docker/nginx first
server {
listen 80;
server_name localhost;
root /var/www/html;
index index.php index.html;
location / {
try_files $uri /index.php$is_args$args;
}
location ~ \.php$ {
fastcgi_pass php:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
.env.example
Optional — Compose uses ${VAR-default} fallbacks
WEB_PORT=8080 POSTGRES_PORT=5432 POSTGRES_DB=app POSTGRES_USER=app POSTGRES_PASSWORD=secret RABBITMQ_PORT=5672 RABBITMQ_MANAGEMENT_PORT=15672 RABBITMQ_DEFAULT_USER=app RABBITMQ_DEFAULT_PASS=secret