nicoherbigde/typo3-cms-php

PHP for TYPO3 CMS 镜像文档

1. 镜像概述

本镜像为TYPO3 CMS（企业级内容管理系统）提供专用PHP运行环境，基于官方PHP镜像构建，针对TYPO3 CMS的技术需求进行深度优化。通过预安装核心扩展、配置性能参数及安全加固，简化TYPO3 CMS部署流程，确保系统在开发、测试及生产环境中稳定高效运行。

2. 核心功能与特性

2.1 预配置核心扩展

默认安装TYPO3 CMS必需的PHP扩展，包括：

• 数据库支持：mysqli、pdo_mysql
• 图像处理：gd（支持JPEG/PNG/GIF）
• 网络通信：curl
• 字符串处理：mbstring、iconv
• 压缩支持：zip、zlib
• 国际化：intl
• 缓存优化：opcache

2.2 性能优化

• 默认启用OPcache加速PHP执行，提升TYPO3页面响应速度
• 合理配置内存限制（默认256M）、最大执行时间（默认30秒）等参数
• 支持通过环境变量灵活调整性能配置，适应不同负载需求

2.3 版本兼容性

• 支持TYPO3 CMS 9LTS及以上版本
• 兼容官方推荐的PHP版本（如TYPO3 12需PHP 8.1+，TYPO3 11需PHP 7.4+）
• 提供多标签选择，匹配不同PHP版本需求（如8.2-fpm、8.1-fpm-alpine）

2.4 安全加固

• 禁用eval、exec等危险PHP函数（可通过配置调整）
• 遵循TYPO3安全最佳实践，设置适当的文件权限
• 基于官方PHP镜像定期更新，修复安全漏洞

3. 使用场景与适用范围

3.1 开发环境

供开发者本地搭建TYPO3 CMS开发环境，快速启动并测试代码变更，无需手动配置PHP环境。

3.2 测试环境

在CI/CD流程中作为自动化测试环境，验证TYPO3 CMS版本升级、插件兼容性及功能稳定性。

3.3 生产环境

企业级TYPO3 CMS网站部署，支持高并发访问，确保系统稳定性和安全性，降低运维复杂度。

3.4 用户群体

• 个人开发者：简化TYPO3学习和开发流程
• 企业IT团队：标准化部署环境，减少环境配置差异导致的问题
• 网站运维人员：快速扩展或迁移TYPO3站点，提升部署效率

4. 使用方法与配置说明

4.1 基本使用（docker run）

通过以下命令启动PHP环境（需配合数据库和Web服务器使用）：

bash
docker run -d \
  --name typo3-php \
  -p 9000:9000 \  # PHP-FPM端口（根据Web服务器配置调整）
  -v /path/to/typo3/files:/var/www/html \  # 挂载TYPO3代码目录
  -e PHP_MEMORY_LIMIT=512M \  # 调整内存限制
  -e TYPO3_CONTEXT=Production \  # 设置TYPO3运行上下文
  [镜像名称]:[标签]  # 如 typo3-php:8.2-fpm

4.2 Docker Compose 完整示例

推荐使用Docker Compose整合PHP、MariaDB（数据库）和Nginx（Web服务器），配置如下：

yaml
version: '3.8'

services:
  # PHP服务
  php:
    image: [镜像名称]:8.2-fpm  # 使用PHP 8.2 FPM版本
    volumes:
      - ./typo3:/var/www/html  # 本地TYPO3代码目录
      - ./php/conf.d:/usr/local/etc/php/conf.d  # 挂载自定义PHP配置
    environment:
      - PHP_MEMORY_LIMIT=512M
      - PHP_MAX_EXECUTION_TIME=60
      - PHP_UPLOAD_MAX_FILESIZE=20M
      - TYPO3_CONTEXT=Production
    depends_on:
      - db

  # 数据库服务（MariaDB）
  db:
    image: mariadb:10.6
    volumes:
      - mariadb-data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=rootpasswd
      - MYSQL_DATABASE=typo3_db
      - MYSQL_USER=typo3_user
      - MYSQL_PASSWORD=typo3_passwd
    ports:
      - "3306:3306"

  # Web服务器（Nginx）
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./typo3:/var/www/html
      - ./nginx/conf.d:/etc/nginx/conf.d  # Nginx配置（需包含TYPO3规则）
    depends_on:
      - php

volumes:
  mariadb-data:  # 数据库数据持久化

4.3 环境变量配置

支持通过环境变量自定义PHP及TYPO3参数，常用变量如下：

4.4 自定义PHP配置

如需覆盖默认配置，可挂载自定义ini文件到容器的/usr/local/etc/php/conf.d/目录：

bash
# 本地创建自定义配置文件
echo "upload_max_filesize = 20M" > /path/to/custom/uploads.ini

# 启动时挂载
docker run -d \
  -v /path/to/custom/uploads.ini:/usr/local/etc/php/conf.d/uploads.ini \
  [镜像名称]:[标签]

4.5 安装额外扩展

如需添加默认未包含的PHP扩展，可通过docker-php-ext-install命令（基于Debian基础镜像）：

bash
# 进入容器
docker exec -it typo3-php bash

# 安装示例：soap扩展
docker-php-ext-install soap

# 安装需依赖的扩展（如gd需libpng等）
apt-get update && apt-get install -y libpng-dev
docker-php-ext-configure gd --with-png-dir=/usr/include/
docker-php-ext-install gd

5. 注意事项

• 数据持久化：TYPO3代码目录、用户上传文件（fileadmin）需通过卷挂载持久化，避免容器删除导致数据丢失。

• 数据库依赖：TYPO3 CMS依赖数据库（MySQL/MariaDB），需确保数据库服务先于PHP服务启动，可通过depends_on（Docker Compose）控制启动顺序。

• 版本匹配：选择镜像标签时，需确保PHP版本与TYPO3 CMS版本兼容（参考TYPO3官方文档）。

• 安全配置：生产环境中应：

  • 使用非root用户运行容器
  • 限制容器网络访问（如通过networks配置隔离）
  • 定期更新镜像以获取安全补丁
  • 避免将敏感信息（如数据库密码）直接写入配置文件，优先使用环境变量注入。

• 性能调优：高流量站点可调整PHP_MEMORY_LIMIT（建议512M+）、启用Nginx缓存、配置OPcache预加载等进一步优化性能。