Laravel容器化生产部署实战：从零构建高可用架构

Laravel容器化生产部署实战：从零构建高可用架构

【免费下载链接】docsSource repo for Docker's Documentation项目地址: https://gitcode.com/gh_mirrors/docs3/docs

在当今云原生时代，Docker已成为PHP应用部署的标准配置。本文通过实际案例，手把手教你如何为Laravel框架搭建一个稳定、高效且易于扩展的容器化生产环境。我们将从基础架构设计到实际部署，覆盖完整的技术栈。

🚀 架构设计：打造坚如磐石的基础

现代Laravel应用需要处理复杂的业务逻辑和高并发请求，合理的架构设计是成功的基石。

核心服务组件：

• Web服务器：Nginx处理静态资源和请求转发
• 应用处理器：PHP-FPM运行Laravel核心代码
• 数据存储层：PostgreSQL/MySQL数据库
• 缓存与队列：Redis支持会话和任务处理

🔧 实战配置：生产级Dockerfile精讲

PHP-FPM生产镜像优化

采用多阶段构建策略，确保最终镜像既轻量又安全：

# 构建阶段：安装依赖和编译扩展 FROM php:8.4-fpm AS builder # 安装Laravel必需的PHP扩展 RUN apt-get update && apt-get install -y \ libpq-dev libzip-dev libicu-dev \ && docker-php-ext-install pdo_mysql zip intl opcache 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生产配置调优

针对Laravel应用特点，优化Nginx配置：

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; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } }

📊 避坑指南：生产部署常见问题

权限问题快速解决

# 修复storage目录权限 docker compose exec php-fpm chmod -R 775 storage bootstrap/cache

数据库连接优化

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

🎯 完整生产配置：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:

🔍 性能监控：确保服务稳定性

健康检查配置

healthcheck: test: ["CMD", "pg_isready"] interval: 10s timeout: 5s retries: 5

💡 部署最佳实践

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

🛡️ 安全加固策略

• 使用非root用户运行容器
• 定期更新基础镜像安全补丁
• 限制容器资源使用配额
• 配置最小权限原则

📝 总结与展望

通过本文的容器化配置，你已掌握构建高可用Laravel生产环境的核心技能。这种部署方式不仅提升了应用的可移植性，更为未来的微服务架构升级奠定了坚实基础。

【免费下载链接】docsSource repo for Docker's Documentation项目地址: https://gitcode.com/gh_mirrors/docs3/docs