使用Docker容器化Laravel与PostgreSQL的完整教程

.
├── app/
├── bootstrap/
├── config/
├── database/
├── public/
├── resources/
├── routes/
├── storage/
├── tests/
├── vendor/
├── .env
├── composer.json
├── composer.lock
├── artisan
├── Dockerfile              <-- Laravel 应用的 Dockerfile
└── docker-compose.yml      <-- Docker Compose 配置文件

# 使用官方PHP-FPM镜像作为基础，版本为7.4
FROM php:7.4-fpm

# 设置容器内的工作目录
WORKDIR /app

# 安装系统依赖：
# git, curl: 常用的版本控制和网络工具
# libpng-dev, libonig-dev, libxml2-dev, libzip-dev, zip, unzip: PHP扩展所需的库
# postgresql-client, libpq-dev: PostgreSQL客户端工具和PHP PostgreSQL扩展所需的开发库
# python3, python3-pip: 如果您的项目需要Python脚本或数据科学工具 (可选)
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 && \
    rm -rf /var/lib/apt/lists/* && \
    ln -s /usr/bin/python3 /usr/bin/python

# 安装可选的Python包 (如果需要，可根据项目需求调整)
# RUN pip3 install --no-cache-dir pandas scikit-learn numpy

# 安装并启用PHP扩展：
# pdo_pgsql: PostgreSQL数据库驱动
# mbstring: 多字节字符串支持
# exif: 处理图像元数据
# pcntl: 进程控制 (通常用于队列)
# bcmath: 任意精度数学
# gd: 图像处理库 (需要libpng-dev)
# zip: Zip文件处理 (需要libzip-dev)
RUN docker-php-ext-install -j$(nproc) pdo_pgsql mbstring exif pcntl bcmath gd zip && \
    docker-php-ext-enable gd zip

# 安装Node.js和npm (如果您的Laravel项目使用Laravel Mix或其他前端构建工具，则需要)
# 这里安装的是Node.js 16.x版本
RUN curl -fsSL https://deb.nodesource.com/setup_16.x | bash - \
    && apt-get install -y nodejs && \
    rm -rf /var/lib/apt/lists/*

# 安装Composer (PHP依赖管理器)
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

# 将本地项目文件复制到容器的工作目录
COPY . .

# 安装Laravel项目依赖
# 先删除旧的vendor目录和composer.lock以确保清洁安装
# 使用 --no-dev 和 --optimize-autoloader 进行生产环境优化安装
RUN rm -rf vendor composer.lock && \
    composer install --no-dev --optimize-autoloader

# 设置Laravel存储和缓存目录的权限，确保Web服务器可以写入
RUN chmod -R 775 storage bootstrap/cache && \
    chown -R www-data:www-data /app

# 如果项目使用Laravel Mix，安装Node.js依赖并编译前端资源 (可选)
# RUN npm install && npm run prod

# 暴露PHP-FPM的默认端口
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目录，实现代码热重载
      - /app/vendor # 匿名卷，防止宿主机的vendor目录覆盖容器内的依赖
      - /app/node_modules # 匿名卷，防止宿主机的node_modules目录覆盖容器内的依赖
    ports:
      - "80:8000" # 将宿主机的80端口映射到容器的8000端口
    environment: # 环境变量，用于Laravel连接数据库
      DB_CONNECTION: pgsql
      DB_HOST: postgres_db # 数据库服务名称作为主机名
      DB_PORT: 5432
      DB_DATABASE: your_laravel_db # 替换为您的数据库名称
      DB_USERNAME: your_user # 替换为您的数据库用户名
      DB_PASSWORD: your_password # 替换为您的数据库密码
    depends_on:
      - postgres_db # 确保postgres_db服务在laravel_app之前启动
    networks:
      - app_network # 连接到自定义网络

  # PostgreSQL 数据库服务
  postgres_db:
    container_name: postgres-db-container
    image: postgres:13 # 使用PostgreSQL 13官方镜像
    restart: unless-stopped
    environment: # 数据库环境变量
      POSTGRES_DB: your_laravel_db # 替换为您的数据库名称
      POSTGRES_USER: your_user # 替换为您的数据库用户名
      POSTGRES_PASSWORD: your_password # 替换为您的数据库密码
    volumes:
      - postgres_data:/var/lib/postgresql/data # 数据持久化卷
    ports:
      - "5432:5432" # 将宿主机的5432端口映射到容器的5432端口 (可选，用于外部访问)
    networks:
      - app_network # 连接到自定义网络

# 定义数据卷，用于PostgreSQL数据持久化
volumes:
  postgres_data:

# 定义自定义网络，使服务之间可以相互通信
networks:
  app_network:
    driver: bridge # 默认的桥接网络

DB_CONNECTION=pgsql
DB_HOST=postgres_db # 必须与docker-compose.yml中数据库服务的名称一致
DB_PORT=5432
DB_DATABASE=your_laravel_db # 必须与docker-compose.yml中POSTGRES_DB一致
DB_USERNAME=your_user # 必须与docker-compose.yml中POSTGRES_USER一致
DB_PASSWORD=your_password # 必须与docker-compose.yml中POSTGRES_PASSWORD一致