使用Docker容器化Laravel与PostgreSQL：完整实践指南

your-laravel-project/
├── .env                 # Laravel 环境变量文件
├── Dockerfile           # Laravel 应用的 Docker 构建文件
├── docker-compose.yml   # Docker Compose 编排文件
├── app/
├── bootstrap/
├── config/
├── database/
├── public/
├── resources/
├── routes/
├── storage/
├── tests/
├── vendor/
└── ... (其他Laravel文件)

# 使用官方PHP-FPM运行时作为父镜像
FROM php:7.4-fpm

# 设置工作目录
WORKDIR /app

# 安装系统依赖：Git、Curl、图像处理库、PostgreSQL客户端、压缩工具等
# 注意：Python3及其科学计算库（pandas, scikit-learn, numpy）在此处安装，
# 如果您的Laravel应用不涉及数据科学，可以移除相关行以减小镜像体积。
RUN apt-get update && apt-get install -y \
    git \
    curl \
    libpng-dev \
    libonig-dev \
    libxml2-dev \
    libzip-dev \
    zip \
    unzip \
    vim \
    postgresql-client \
    libpq-dev \
    python3 \
    python3-pip && \
    ln -s /usr/bin/python3 /usr/bin/python

# 安装Python包（可选，如果不需要数据科学工具可移除）
RUN pip3 install --no-cache-dir pandas scikit-learn numpy

# 安装PHP扩展：PostgreSQL PDO、多字节字符串、Exif、进程控制、高精度计算、GD库、Zip
RUN docker-php-ext-install pdo_pgsql mbstring exif pcntl bcmath gd zip
# 启用已安装的GD和Zip扩展
RUN docker-php-ext-enable gd zip

# 安装Node.js和npm（Laravel Mix等前端工具可能需要）
# 这里安装Node.js 16.x版本
RUN curl -fsSL https://deb.nodesource.com/setup_16.x | bash - \
    && apt-get install -y nodejs

# 安装Composer
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

# 将应用程序文件复制到容器中
COPY . .

# 安装Laravel依赖
# 移除旧的vendor目录和composer.lock以确保全新安装
# 使用 composer install --no-dev --optimize-autoloader 优化生产环境的依赖安装
RUN rm -rf vendor composer.lock && composer update && composer install --no-dev --optimize-autoloader

# 设置Laravel目录的权限
# www-data 是 PHP-FPM 进程通常使用的用户和组
RUN chmod -R 775 storage bootstrap/cache && \
    chown -R www-data:www-data /app

# 安装Node.js依赖（如果使用Laravel Mix）
RUN npm install

# 暴露PHP-FPM默认端口9000
EXPOSE 9000

# 启动PHP-FPM服务
CMD ["php-fpm"]

version: '3.8' # 推荐使用较新的Compose文件格式版本

services:
  # Laravel 应用服务
  laravel-app:
    container_name: laravel-app-container # 指定容器名称
    build:
      context: . # Dockerfile 所在的上下文路径
      dockerfile: Dockerfile # 指定 Dockerfile 文件名
    command: 'php artisan serve --host=0.0.0.0 --port=8000' # 启动Laravel开发服务器
    restart: unless-stopped # 容器异常退出时自动重启
    volumes:
      - .:/app # 将宿主机当前目录挂载到容器的 /app 目录，实现代码同步
    ports:
      - "8000:8000" # 将宿主机的 8000 端口映射到容器的 8000 端口
    depends_on:
      - postgres-db # 声明此服务依赖于 postgres-db 服务
    networks:
      - app-network # 将此服务连接到 app-network 网络

  # PostgreSQL 数据库服务
  postgres-db:
    container_name: postgres-db-container # 指定容器名称
    image: postgres:13 # 使用官方 PostgreSQL 13 镜像
    restart: unless-stopped # 容器异常退出时自动重启
    environment: # 设置 PostgreSQL 环境变量
      POSTGRES_DB: laravel_db # 数据库名称
      POSTGRES_USER: laravel_user # 数据库用户
      POSTGRES_PASSWORD: secret # 数据库密码
      # POSTGRES_HOST_AUTH_METHOD: "trust" # 生产环境不推荐，仅用于开发简化认证
    volumes:
      - postgres_data:/var/lib/postgresql/data # 挂载数据卷，实现数据持久化
    ports:
      - "5432:5432" # 将宿主机的 5432 端口映射到容器的 5432 端口
    networks:
      - app-network # 将此服务连接到 app-network 网络

# 定义网络，使服务之间可以互相通信
networks:
  app-network:
    driver: bridge # 使用桥接网络驱动

# 定义数据卷，用于 PostgreSQL 数据的持久化存储
volumes:
  postgres_data:
    driver: local # 使用本地驱动