docker-compose.yml

# Define custom Docker networks
networks:
  project-network:

# Define services for the application
services:

  # PHP service configuration
  php:
    build:
      # Path to the build context
      context: .
      # Dockerfile for PHP
      dockerfile: docker/php/Dockerfile
    # Image name
    image: php83-fpm-alpine
    # Name of the container
    container_name: php
    # Restart policy
    restart: unless-stopped
    # Set the working directory inside the container
    working_dir: /app
    volumes:
      # Bind the project directory to the container
      - ./project:/app
      # Exclude Composer's vendor directory for performance boosting
      - /app/vendor
      # Map PHP logs to the host system for debugging
      - ./logs/php:/var/log/php
    # Environment variable for application configuration
    environment:
      POSTGRES_HOST: ${POSTGRES_HOST}
      POSTGRES_PORT: ${POSTGRES_PORT}
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    # Attach to the custom network
    networks:
      - project-network
    # Update Composer dependencies and start PHP-FPM
    command: sh -c "composer update && php-fpm"

  # Nginx service configuration
  nginx:
    build:
      # Path to the build context
      context: .
      # Dockerfile for Nginx
      dockerfile: docker/nginx/Dockerfile
    # Image name
    image: nginx-alpine
    # Name of the container
    container_name: nginx
    # Restart policy
    restart: unless-stopped
    # Map container port 80 to host port 8000
    ports:
      - "${NGINX_PORT}:80"
    volumes:
      # Bind the project directory to the container
      - ./project:/app
      # Map Nginx logs to the host system for debugging
      - ./logs/nginx:/var/log/nginx
    # Ensure the PHP service starts first
    depends_on:
      - php
    # Attach to the custom network
    networks:
      - project-network

  # Postgres database configuration
  postgres:
    build:
      # Path to the build context
      context: .
      # Dockerfile for PostgreSQL
      dockerfile: docker/postgres/Dockerfile
    # Image name
    image: postgres:17-alpine
    # Container name
    container_name: postgres
    # Restart policy
    restart: unless-stopped
    # Mounted volumes
    volumes:
      # Storage for PostgreSQL data on the host
      - ./data/postgres:/var/lib/postgresql/data
      # Logs PostgreSQL
      - ./logs/postgres:/var/log/postgresql
    # Environment variables
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      PGDATA: ${POSTGRES_PGDATA}
    ports:
      - "${POSTGRES_PORT}:5432"
    # Connection to the database
    networks:
      - project-network

  # pgAdmin configuration
  pgadmin:
    image: dpage/pgadmin4
    container_name: pgadmin
    # Restart policy
    restart: unless-stopped
    ports:
      - "${PGADMIN_PORT}:80"
    # Environment variables
    environment:
      PGADMIN_DEFAULT_EMAIL: ${PGADMIN_EMAIL}
      PGADMIN_DEFAULT_PASSWORD: ${PGADMIN_PASSWORD}
    # Mounted volumes
    volumes:
      - ./data/pgadmin:/var/lib/pgadmin
    # Depends on Postgres database container
    depends_on:
      - postgres
    networks:
      - project-network