symfony-docker 镜像文档

镜像概述

symfony-docker是专为运行Symfony PHP框架应用设计的Docker镜像。该镜像提供多种变体，支持不同PHP版本、Node.js版本及扩展组合，区分开发与生产环境，简化Symfony应用的开发、调试和部署流程。

核心功能与特性

可用变体

镜像标签由以下部分组合而成，支持灵活配置：

• PHP版本：php7.4、php8.0、php8.1
• Node.js版本：-node10、-node12、-node14、-node16（LTS版本）
• 图像处理扩展：-image（包含vips和imagick）
• 开发工具：-dev（包含XDebug调试工具）

示例标签：php8.1-node16-image-dev
查看所有标签

核心特点

• 环境区分：开发镜像（-dev）含XDebug，用于本地调试；生产镜像不含XDebug，优化性能
• 扩展集成：默认包含Symfony运行所需的PHP扩展及Apache模块
• 灵活适配：支持多版本PHP/Node.js组合，满足不同项目依赖需求

镜像概念

设计理念

• 开发环境：使用-dev镜像，通过挂载本地目录到容器，实现代码实时同步与调试
• 生产环境：使用非-dev镜像，将应用代码复制到镜像内部，构建独立部署单元

开发与生产镜像的区别

• 非-dev镜像：面向生产环境，精简配置，不含XDebug，专注性能优化
• -dev镜像：面向开发环境，额外安装XDebug，支持断点调试，便于开发测试

使用场景

• 本地开发：通过-dev镜像快速搭建开发环境，结合Docker Compose管理依赖服务（如数据库、缓存）
• 应用部署：使用非-dev镜像构建生产就绪镜像，部署到 staging 或生产环境

使用方法

开发环境配置（docker-compose.yml）

创建docker-compose.yml文件配置开发环境：

www:
  image: recognizebv/symfony-docker:php8.0-dev  # 使用PHP8.0开发镜像
  volumes:
    - ".:/var/www/html"  # 挂载本地代码目录到容器
  ports:
    - "80:80"  # 映射容器80端口到本地

可根据需求添加数据库、Redis等关联服务容器。

调整Symfony内核配置

修改Symfony应用的Kernel.php，将缓存和日志目录指向/tmp（避免权限问题）：

public function getCacheDir()
{
    return sys_get_temp_dir().'/cache/'.$this->getEnvironment();
}

public function getLogDir()
{
    return sys_get_temp_dir().'/logs/'.$this->getEnvironment();
}

执行docker-compose up启动开发环境。

日志配置（可选）

为使Docker正确捕获日志，可调整config_dev.yml和config_prod.yml，将日志输出到stderr：

path: "php://stderr"

构建生产镜像

创建Dockerfile构建生产环境镜像：

FROM recognizebv/symfony-docker:php8.0  # 使用PHP8.0生产镜像
ADD . /var/www/html  # 复制应用代码到镜像
# 添加应用构建步骤（如安装依赖、生成资产）
# RUN ./var/www/html/bin/console assets:install
RUN rm -rf /var/www/html/web/app_dev.php  # 移除开发环境文件
RUN rm -rf /var/www/html/web/config.php    # 移除配置调试文件

常见问题（FAQ）

默认启用哪些扩展？

• Apache模块：mod_rewrite
• PHP扩展：intl、opcache、pdo、pdo_mysql、pdo_pgsql、zip、gd
• 开发镜像额外包含：XDebug

如何安装额外PHP扩展？

基于PHP镜像构建，可使用docker-php-ext-install命令安装扩展。详情参考PHP镜像文档。

为什么无法访问app_dev.php？

Symfony默认限制非本地请求访问app_dev.php。可编辑app_dev.php文件修改访问控制逻辑。