Symfony Docker镜像文档

概述

Symfony Docker镜像是针对Symfony PHP Web框架优化的容器化运行环境，集成了Symfony运行所需的基础组件（如PHP、Web服务器、Composer等），支持多PHP版本选择，提供灵活的环境配置，适用于Symfony应用的开发、测试及生产环境部署。

核心功能与特性

• 多PHP版本支持：提供多种PHP版本标签（如8.2、8.1等），适配不同Symfony版本的PHP需求
• 内置Web服务器：集成Nginx或Apache作为Web服务器，支持FastCGI进程管理
• 开发友好：包含Composer工具，支持代码热加载（开发环境），便于实时调试
• 环境隔离：通过环境变量区分开发/测试/生产环境（APP_ENV），避免环境配置冲突
• 轻量级设计：基于官方PHP镜像优化，减少冗余依赖，降低镜像体积

使用场景

• 本地开发环境：快速搭建一致的Symfony开发环境，避免本地环境差异问题
• CI/CD流程：作为持续集成/部署流程中的运行环境，执行测试、构建及部署任务
• 生产环境部署：通过优化配置（如禁用开发工具、启用缓存），支持生产环境稳定运行
• 多环境测试：在同一主机上快速切换不同PHP版本或Symfony配置，验证应用兼容性

使用方法

基本使用（Docker Run）

开发环境示例

docker run -d \
  --name symfony-dev \
  -p 8000:8000 \
  -v $(pwd):/app \
  -e APP_ENV=dev \
  -e DATABASE_URL="mysql://user:pass@mysql:3306/symfony" \
  symfony:8.2-dev

• -v $(pwd):/app：挂载本地Symfony项目目录到容器内，实现代码热更新
• -e APP_ENV=dev：指定开发环境，启用调试模式及错误显示
• -p 8000:8000：映射容器内Web服务器端口到本地

生产环境示例

docker run -d \
  --name symfony-prod \
  -p 80:80 \
  -e APP_ENV=prod \
  -e APP_SECRET="your-secure-secret" \
  -e DATABASE_URL="mysql://user:pass@mysql:3306/symfony_prod" \
  --restart always \
  symfony:8.2-prod

• --restart always：配置容器自动重启，增强生产环境稳定性
• APP_ENV=prod：启用生产环境配置，禁用调试工具，启用缓存优化

Docker Compose配置示例

version: '3.8'

services:
  symfony:
    image: symfony:8.2
    container_name: symfony-app
    ports:
      - "80:80"
    environment:
      - APP_ENV=prod
      - APP_SECRET=your-app-secret
      - DATABASE_URL=mysql://symfony_user:password@db:3306/symfony_db
    volumes:
      - ./app:/app  # 开发环境挂载代码目录，生产环境可移除或只读挂载
      - symfony_cache:/app/var/cache
      - symfony_logs:/app/var/log
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: mysql:8.0
    container_name: symfony-db
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=symfony_db
      - MYSQL_USER=symfony_user
      - MYSQL_PASSWORD=password
    volumes:
      - mysql_data:/var/lib/mysql
    restart: unless-stopped

volumes:
  mysql_data:
  symfony_cache:
  symfony_logs:

环境变量配置

开发环境使用技巧

1. 代码热加载：通过-v $(pwd):/app挂载本地Symfony项目目录，修改代码后无需重建镜像即可生效
2. 调试工具启用：设置APP_ENV=dev并安装Symfony Debug Bundle，可通过/_profiler访问调试面板
3. Composer依赖管理：通过docker exec -it symfony-dev composer require <package>在容器内安装依赖

生产环境优化建议

1. 使用多阶段构建：构建阶段使用symfony:dev镜像安装依赖，运行阶段使用symfony:prod镜像，减少镜像体积
2. 禁用开发工具：确保APP_ENV=prod，并删除require-dev依赖（通过composer install --no-dev）
3. 启用缓存：Symfony生产环境默认启用OPcache和应用缓存，可通过php bin/console cache:warmup预生成缓存
4. 日志持久化：挂载日志目录（如/app/var/log）到宿主机或外部存储，避免容器重启丢失日志

版本标签说明

镜像标签遵循{php-version}-{environment}格式，例如：

• 8.2：PHP 8.2版本，默认生产环境配置
• 8.1-dev：PHP 8.1版本，开发环境配置（含调试工具）
• latest：最新稳定PHP版本的生产环境配置