nicoherbigde/symfony-php

PHP for Symfony 镜像文档

镜像概述

PHP for Symfony镜像是专为Symfony框架设计的PHP运行环境镜像，基于官方PHP镜像构建，针对Symfony应用的运行需求进行了深度优化。该镜像预装了Symfony框架必需的PHP扩展、依赖管理工具及开发/生产环境配置，旨在降低Symfony项目容器化的复杂度，提升开发与部署效率。

核心功能与特性

• 预装Symfony依赖扩展：包含Symfony框架运行必需的PHP扩展，如mbstring、xml、json、pdo_mysql、intl、opcache等，无需手动安装。
• 集成开发工具：内置Composer（PHP依赖管理工具）和Symfony CLI（Symfony命令行工具），支持项目创建、依赖安装、缓存清理等常用操作。
• 多PHP版本支持：提供多个PHP版本标签（如7.4、8.0、8.1、8.2），适配不同Symfony版本需求（Symfony 4+推荐PHP 7.4+，Symfony 6+推荐PHP 8.0+）。
• 环境模式切换：支持开发（dev）、测试（test）、生产（prod）环境配置，开发环境默认启用Xdebug调试工具，生产环境优化性能与安全性（如禁用调试、启用OPcache）。
• 兼容性设计：兼容Docker Compose、Kubernetes等容器编排工具，支持与Nginx、MySQL等服务集成，满足复杂应用架构需求。

使用场景

• 本地开发环境：快速搭建一致的Symfony开发环境，避免因本地PHP版本/扩展差异导致的"在我电脑上能运行"问题，支持代码热重载与调试。
• CI/CD流程：作为持续集成/持续部署的基础镜像，用于自动化测试（如PHPUnit）、代码质量检查（如PHPStan）及应用构建。
• 生产环境部署：通过生产模式配置，构建轻量级、安全的Symfony应用运行实例，配合PHP-FPM与Nginx实现高性能部署。

使用方法与配置说明

快速启动（docker run）

开发环境示例

bash
docker run -d \
  --name symfony-dev \
  -v $(pwd):/app \  # 挂载本地Symfony项目目录到容器内/app
  -p 8000:8000 \    # 映射Symfony开发服务器端口
  -e APP_ENV=dev \   # 设置为开发环境
  php-for-symfony:8.2-dev \
  symfony server:start --port=8000 --address=0.0.0.0  # 启动Symfony开发服务器

• 访问http://localhost:8000即可查看运行中的Symfony应用。
• 代码修改后无需重启容器，Symfony开发服务器会自动热重载。

生产环境示例（配合PHP-FPM）

bash
docker run -d \
  --name symfony-prod \
  -v $(pwd):/app \
  -e APP_ENV=prod \
  -e APP_SECRET=your-secure-secret-key \  # 设置应用密钥（必填）
  php-for-symfony:8.2-prod \
  php-fpm  # 启动PHP-FPM服务（需配合Nginx反向代理）

生产环境建议使用Nginx作为前端代理，处理静态资源并转发动态请求至PHP-FPM。

Docker Compose配置示例

创建docker-compose.yml文件，集成PHP与数据库服务：

yaml
version: '3.8'

services:
  php:
    image: php-for-symfony:8.2-dev
    volumes:
      - ./:/app  # 挂载本地项目目录
    ports:
      - "8000:8000"  # 开发服务器端口
    environment:
      - APP_ENV=dev
      - DATABASE_URL=mysql://symfony_user:symfony_pass@db:3306/symfony_db  # Doctrine数据库连接
    depends_on:
      - db  # 依赖数据库服务
    command: symfony server:start --port=8000 --address=0.0.0.0

  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root_pass
      - MYSQL_DATABASE=symfony_db
      - MYSQL_USER=symfony_user
      - MYSQL_PASSWORD=symfony_pass
    ports:
      - "3306:3306"  # 映射数据库端口（可选，本地调试用）
    volumes:
      - mysql-data:/var/lib/mysql  # 持久化数据库数据

volumes:
  mysql-data:  # 定义数据卷，确保数据持久化

启动服务：docker-compose up -d，停止服务：docker-compose down。

环境变量说明

扩展与自定义

如需安装额外PHP扩展（如redis、gd），可通过以下方式：

临时安装（进入容器后执行）

bash
docker exec -it symfony-dev docker-php-ext-install redis  # 安装redis扩展
docker exec -it symfony-dev docker-php-ext-enable redis   # 启用扩展

构建自定义镜像（推荐生产环境）

创建Dockerfile：

dockerfile
FROM php-for-symfony:8.2-prod

# 安装redis扩展
RUN docker-php-ext-install redis \
    && docker-php-ext-enable redis

# 复制自定义PHP配置
COPY ./php.ini /usr/local/etc/php/conf.d/custom.ini

构建镜像：docker build -t my-symfony-php .