keyclic/php-symfony

Symfony项目PHP运行镜像

镜像概述

本镜像专为运行Symfony项目设计，提供适配Symfony框架需求的PHP运行环境及基础配置，旨在简化Symfony应用的部署与运行流程，减少环境配置复杂度。

核心功能与特性

• Symfony适配环境：内置与Symfony框架兼容的PHP版本（支持PHP 7.4+及8.x，具体版本取决于镜像标签），满足Symfony对PHP版本的依赖要求。
• 预装必要扩展：包含Symfony运行所需的PHP扩展，如mbstring、xml、pdo、json、ctype等，避免手动安装扩展的繁琐步骤。
• 基础配置优化：默认php.ini配置针对Symfony应用进行基础优化，如合理的内存限制、执行时间设置等。
• Composer集成：预装Composer包管理器，支持Symfony项目依赖的安装与管理。

使用场景

• Symfony应用开发环境：本地开发时快速搭建一致的PHP运行环境，避免因环境差异导致的问题。
• Symfony应用部署：作为生产或测试环境的基础镜像，简化Symfony应用的容器化部署流程。

使用方法与配置说明

基础使用

通过挂载Symfony项目目录并映射端口，即可启动应用：

bash
docker run -d \
  -v /本地/symfony项目路径:/app \
  -p 8080:80 \
  [镜像名称]:[标签]

环境变量

可通过环境变量调整运行配置，常用变量包括：

• APP_ENV：应用环境（默认dev，可选prod、test），影响Symfony的环境配置加载。
• PHP_MEMORY_LIMIT：PHP内存限制（默认256M）。
• PHP_MAX_EXECUTION_TIME：PHP最大执行时间（默认30秒）。

示例：设置生产环境及内存限制

bash
docker run -d \
  -v /本地/symfony项目路径:/app \
  -p 80:80 \
  -e APP_ENV=prod \
  -e PHP_MEMORY_LIMIT=512M \
  [镜像名称]:[标签]

自定义配置

如需覆盖默认php.ini配置，可通过挂载自定义配置文件实现：

bash
docker run -d \
  -v /本地/symfony项目路径:/app \
  -v /本地/custom-php.ini:/usr/local/etc/php/php.ini \
  -p 80:80 \
  [镜像名称]:[标签]

部署示例

Docker Compose配置

创建docker-compose.yml文件，整合应用服务与可能的数据库等依赖：

yaml
version: '3'
services:
  symfony-app:
    image: docker.xuanyuan.run/[镜像名称]:[标签]
    ports:
      - "80:80"
    volumes:
      - ./symfony-project:/app
    environment:
      - APP_ENV=prod
      - PHP_MEMORY_LIMIT=512M
    depends_on:
      - db
  db:
    image: docker.xuanyuan.run/mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=symfony_db

启动服务：

bash
docker-compose up -d

注意事项

• 镜像标签通常对应不同PHP版本，使用前需确认目标Symfony项目支持的PHP版本，并选择匹配的镜像标签。
• 生产环境中建议结合持久化存储、网络配置及安全最佳实践进行部署，如限制容器权限、使用非root用户运行等。