docker-symfony 镜像文档

概述

docker-symfony是一个专为Symfony框架设计的Docker镜像，旨在简化Symfony应用的部署与运行流程。该镜像集成了Symfony应用所需的完整运行环境，包括预配置的PHP解释器、Web服务器（Nginx/Apache）、依赖管理工具（Composer）及环境配置模板，可直接用于开发、测试或生产环境，无需手动搭建底层基础设施。

核心功能与特性

预配置运行环境

• 内置多个PHP版本支持（默认8.2，可选8.1/8.3），适配Symfony 4+框架需求
• 集成Nginx/Apache作为Web服务器，预配置Symfony路由规则与静态资源处理策略
• 包含Composer工具，支持一键安装Symfony依赖包（composer install）

灵活的环境配置

• 通过环境变量动态调整应用参数（如数据库连接、日志级别、缓存策略）
• 支持多环境配置（开发/测试/生产），通过APP_ENV变量一键切换
• 内置环境变量模板，简化数据库（MySQL/PostgreSQL）、Redis等服务的连接配置

开发与生产优化

• 开发模式：支持代码热重载（通过卷挂载）、Xdebug调试工具集成
• 生产模式：启用OPcache优化、日志轮转、安全头配置，减小镜像体积（多阶段构建）
• 兼容Docker Compose与Kubernetes，支持容器编排与服务扩展

扩展性支持

• 支持自定义配置文件挂载（如php.ini、Nginx虚拟主机配置）
• 提供健康检查接口，便于容器编排平台监控应用状态
• 兼容主流CI/CD工具（GitHub Actions、GitLab CI），支持自动化部署流程

使用场景

开发环境快速搭建

适用于开发者本地快速启动Symfony应用，无需手动配置PHP、Web服务器及依赖，通过卷挂载实现代码实时修改与效果预览。

生产环境部署

可直接用于生产环境，通过环境变量注入敏感配置（如数据库凭证），配合持久化存储卷实现数据持久化，支持高可用部署。

CI/CD流程集成

作为CI/CD流水线的基础镜像，用于自动化测试（单元测试、功能测试）、构建优化及部署验证，确保代码合并前的环境一致性。

使用方法与配置说明

基本使用（Docker Run）

开发环境启动

docker run -d \
  -p 80:80 \
  -e APP_ENV=dev \
  -e DATABASE_URL="mysql://user:password@db:3306/symfony" \
  -v $(pwd):/app \  # 挂载本地Symfony代码目录
  -v symfony_logs:/var/log/symfony \  # 挂载日志目录
  --name symfony-app \
  sctr/docker-symfony

生产环境启动（最小化配置）

docker run -d \
  -p 80:80 \
  -e APP_ENV=prod \
  -e APP_SECRET="your-secure-secret-key" \
  -e DATABASE_URL="postgresql://user:password@db:5432/symfony" \
  -e PHP_MEMORY_LIMIT=512M \
  --restart=always \
  --name symfony-prod \
  sctr/docker-symfony

Docker Compose配置示例

version: '3.8'

services:
  symfony:
    image: sctr/docker-symfony
    ports:
      - "80:80"
    environment:
      - APP_ENV=dev
      - APP_SECRET=dev-secret-key
      - DATABASE_URL=mysql://symfony_user:symfony_pass@db:3306/symfony_db
      - PHP_VERSION=8.2
      - WEB_SERVER=nginx
      - PHP_MEMORY_LIMIT=256M
    volumes:
      - ./symfony-app:/app  # 本地代码目录挂载（开发用）
      - symfony_logs:/var/log/symfony
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root-pass
      - MYSQL_DATABASE=symfony_db
      - MYSQL_USER=symfony_user
      - MYSQL_PASSWORD=symfony_pass
    volumes:
      - mysql_data:/var/lib/mysql
    restart: unless-stopped

volumes:
  symfony_logs:
  mysql_data:

核心环境变量配置

卷挂载说明

生产环境部署注意事项

1. 安全配置

   • 务必设置高强度APP_SECRET（可通过openssl rand -hex 32生成）
   • 限制容器权限，使用非root用户运行（镜像内置www-data用户）
   • 通过环境变量注入敏感信息，避免硬编码配置文件

2. 性能优化

   • 启用OPcache（生产环境默认开启）并调整opcache.memory_consumption参数
   • 使用Redis/Memcached替代文件缓存，通过CACHE_DRIVER变量配置
   • 配置CDN加速静态资源，减少容器资源占用

3. 高可用保障

   • 使用Docker Swarm/Kubernetes实现容器编排与自动扩缩容
   • 配置健康检查（HEALTHCHECK --interval=30s --timeout=3s CMD curl -f http://localhost/health || exit 1）
   • 实现日志集中管理（如对接ELK栈）与监控告警（如Prometheus）