Docker环境下Laravel生产环境部署指南

前言

在现代Web开发中，Docker已成为部署PHP应用的标准工具之一。本文将详细介绍如何使用Docker Compose为Laravel框架搭建一个生产级别的运行环境。通过容器化部署，我们可以确保开发、测试和生产环境的一致性，同时提高应用的可扩展性和安全性。

项目结构设计

一个合理的项目结构是高效部署的基础。以下是推荐的Laravel项目结构：

my-laravel-app/
├── app/
├── bootstrap/
├── config/
├── database/
├── public/
├── docker/
│   ├── common/          # 共享配置
│   ├── production/      # 生产环境专用配置
│   │   ├── php-fpm/     # PHP-FPM相关配置
│   │   └── nginx/       # Nginx配置
├── compose.prod.yaml    # 生产环境Compose文件
├── .env                 # 环境变量配置
└── ...

这种结构将Docker配置集中管理，同时分离开发和生产环境配置，便于维护。

PHP-FPM生产环境镜像构建

PHP-FPM是Laravel应用的核心处理引擎。以下是生产环境Dockerfile的关键要点：

1. 多阶段构建：减少最终镜像体积，只包含运行时必要的组件
2. 安全优化：使用非root用户(www-data)运行应用
3. 健康检查：集成php-fpm-healthcheck监控服务状态
4. 性能优化：使用生产版php.ini配置

# 构建阶段
FROM php:8.4-fpm AS builder

# 安装构建依赖和PHP扩展
RUN apt-get update && apt-get install -y \
    libpq-dev libzip-dev libicu-dev \
    && docker-php-ext-install pdo_mysql zip intl

WORKDIR /var/www
COPY . .
RUN composer install --no-dev --optimize-autoloader

# 生产阶段
FROM php:8.4-fpm
COPY --from=builder /var/www /var/www
RUN chown -R www-data:www-data /var/www
USER www-data
CMD ["php-fpm"]

Nginx生产环境配置

Nginx作为前端Web服务器，需要特别优化以服务Laravel应用：

1. 静态资源处理：高效服务JS/CSS等静态文件
2. PHP-FPM转发：正确处理PHP请求路由
3. 性能调优：连接数、缓冲区等参数优化

server {
    listen 80;
    root /var/www/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass php-fpm:9000;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

数据库服务配置

生产环境数据库需要特别注意：

1. 数据持久化：使用volume保存数据库数据
2. 健康检查：确保应用启动前数据库已就绪
3. 性能优化：根据负载调整资源配置

postgres:
  image: postgres:16
  volumes:
    - postgres-data:/var/lib/postgresql/data
  healthcheck:
    test: ["CMD", "pg_isready"]
    interval: 10s
    timeout: 5s
    retries: 5

完整的Docker Compose配置

将各服务整合到compose.prod.yaml中：

services:
  web:
    build: ./docker/production/nginx
    ports:
      - "80:80"
    depends_on:
      php-fpm:
        condition: service_healthy

  php-fpm:
    build:
      context: .
      dockerfile: ./docker/common/php-fpm/Dockerfile
    healthcheck:
      test: ["CMD-SHELL", "php-fpm-healthcheck"]
      interval: 10s

  postgres:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

部署与运维实践

1. 启动服务：

   docker compose -f compose.prod.yaml up -d --build
   

2. 执行迁移：

   docker compose -f compose.prod.yaml exec php-fpm php artisan migrate --force
   

3. 监控日志：

   docker compose -f compose.prod.yaml logs -f
   

4. 性能调优建议：

   • 根据负载调整PHP-FPM进程数
   • 配置OPcache提高PHP性能
   • 使用Redis作为缓存和会话驱动

安全最佳实践

1. 使用非root用户运行容器
2. 定期更新基础镜像和安全补丁
3. 限制容器资源使用(CPU/内存)
4. 配置适当的文件权限
5. 使用secret管理敏感信息

常见问题解决

1. 权限问题：确保storage目录可写

   chmod -R 775 storage bootstrap/cache
   

2. 性能问题：检查OPcache是否启用

   phpinfo();
   

3. 数据库连接问题：验证服务名称解析

   docker compose exec php-fpm ping postgres
   

结语

通过本文的Docker生产环境配置，您可以获得一个稳定、高效且易于扩展的Laravel运行环境。容器化部署不仅简化了运维工作，还提高了应用的可移植性。建议根据实际业务需求进一步优化配置参数，并建立完善的监控系统以确保服务稳定性。