dlxmedia/docker-symfony

Symfony Docker镜像文档

镜像概述

Symfony Docker镜像专为简化Symfony PHP Web框架应用的部署与开发而设计。该镜像基于官方PHP镜像构建，预配置了Symfony运行所需的核心依赖（如PHP扩展、Web服务器等），支持快速启动Symfony应用，减少环境配置复杂度。

核心功能与特性

• 预配置环境：包含Symfony运行必需的PHP扩展（mbstring、xml、pdo、json等）及Web服务器（Nginx/Apache，依版本而定）
• 多版本支持：提供针对Symfony 4/5/6等主流版本的标签，适配不同项目需求
• 双环境支持：同时支持开发环境（含调试工具、热重载）和生产环境（性能优化、安全加固）
• 灵活配置：通过环境变量自定义PHP配置、Web服务器参数及Symfony应用设置
• 轻量级设计：基于Alpine或Debian Slim基础镜像，平衡功能与镜像体积

使用场景与适用范围

• 本地开发：快速搭建一致的Symfony开发环境，避免环境差异导致的问题
• 生产部署：简化Symfony应用的生产环境部署流程，确保环境一致性
• CI/CD集成：作为自动化测试、构建和部署流程中的运行环境
• 教学与演示：快速展示Symfony应用功能，降低环境配置门槛

使用方法与配置说明

快速启动（docker run）

开发环境示例

bash
docker run -d \
  -p 8000:8000 \
  -v $(pwd):/app \
  -e SYMFONY_ENV=dev \
  symfony:latest \
  php bin/console server:run 0.0.0.0:8000

说明：通过-v $(pwd):/app挂载本地Symfony项目目录，实现代码热更新；SYMFONY_ENV=dev启用开发模式

生产环境示例

bash
docker run -d \
  -p 80:80 \
  -v $(pwd):/app \
  -e SYMFONY_ENV=prod \
  -e APP_ENV=prod \
  -e APP_SECRET=your_secret_key \
  -e DATABASE_URL=mysql://user:pass@db:3306/dbname \
  symfony:latest \
  nginx -g 'daemon off;'

说明：生产环境默认使用Nginx作为Web服务器，需配置APP_SECRET和DATABASE_URL等必要环境变量

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  symfony:
    image: symfony:latest
    ports:
      - "80:80"
    volumes:
      - ./:/app
    environment:
      - SYMFONY_ENV=prod
      - APP_ENV=prod
      - APP_SECRET=your_secret_key_here
      - DATABASE_URL=mysql://user:pass@db:3306/symfony_db
      - PHP_MEMORY_LIMIT=512M
      - WEB_SERVER=nginx
    depends_on:
      - db

  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=symfony_db
      - MYSQL_USER=user
      - MYSQL_PASSWORD=pass
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

环境变量说明

常用操作

1. 安装依赖：进入容器执行Composer命令

   bash
   docker exec -it [容器ID] composer install --no-dev --optimize-autoloader
   

2. 数据库迁移：执行Symfony控制台命令

   bash
   docker exec -it [容器ID] php bin/console doctrine:migrations:migrate
   

3. 缓存清理（生产环境）：

   bash
   docker exec -it [容器ID] php bin/console cache:clear --env=prod --no-debug
   

4. 查看应用日志：

   bash
   docker exec -it [容器ID] tail -f var/log/prod.log