TYPO3专用PHP镜像文档

镜像概述

本镜像为TYPO3 CMS提供专用PHP运行环境，基于标准PHP镜像构建，针对TYPO3应用场景优化配置。镜像默认以非root用户（UID 1000）运行，提升容器安全性，并预装xdebug调试工具，简化开发阶段的代码调试流程。

核心功能与特性

• TYPO3兼容性：针对TYPO3 CMS各版本运行需求优化，确保与TYPO3核心及常用扩展兼容
• 安全运行模式：默认使用用户1000（非root）执行进程，降低容器安全风险
• 预装xdebug：集成xdebug调试扩展，支持断点调试、性能分析等开发功能
• 标准PHP环境：包含TYPO3运行所需的常用PHP扩展（如mysqli、gd、mbstring等）

使用场景与适用范围

• TYPO3 CMS开发环境搭建
• 本地开发调试TYPO3主题或扩展
• CI/CD流程中的TYPO3应用测试环境
• 需要xdebug调试功能的TYPO3开发场景

使用方法与配置说明

基础运行命令

docker run -d \
  --name typo3-php \
  -v /path/to/typo3/project:/app \
  -p 8080:80 \
  [镜像名称]

注：请将[镜像名称]替换为实际镜像标签，/path/to/typo3/project替换为本地TYPO3项目目录

环境变量配置

xdebug调试配置

通过环境变量自定义xdebug参数：

docker run -d \
  --name typo3-php-dev \
  -v /path/to/typo3/project:/app \
  -p 8080:80 \
  -e XDEBUG_MODE=debug,profile \
  -e XDEBUG_CLIENT_HOST=192.168.1.100 \
  [镜像名称]

Docker Compose示例

version: '3.8'
services:
  typo3-php:
    image: [镜像名称]
    container_name: typo3-php
    volumes:
      - ./typo3-project:/app
    ports:
      - "8080:80"
    environment:
      - PHP_INI_MEMORY_LIMIT=512M
      - XDEBUG_MODE=debug,develop
      - XDEBUG_CLIENT_HOST=host.docker.internal
    user: "1000:1000"  # 可覆盖用户身份（默认已为1000）

用户身份说明

镜像默认使用UID/GID 1000的用户运行进程，挂载主机目录时需确保本地目录权限对用户1000可读写，或通过-u参数临时调整用户身份：

docker run -d --name typo3-php -v ./typo3:/app -u $(id -u):$(id -g) [镜像名称]