用途:当需要运行、启动或访问 TYPO3 实例时使用,覆盖 DDEV 命令、后端 URL、DDEV 环境搭建与多版本测试;也处理 DDEV 无法运行的场景。
主要能力:支持 TYPO3 v11/12/13/14 多版本安装与测试,v14.3 LTS 为默认;提供数据库选择(MariaDB 10.11 默认,另有 SQLite、PostgreSQL 16、MySQL 8.0)、PHP 版本管理、可选服务(Valkey 8 默认或 Redis 7、Ofelia 调度)以及故障排查指引。
使用方式:URL 不可猜测,需读取 .ddev/config.yaml 中的 name:,再套用子域名模式:https://v{VERSION}.{sitename}.ddev.site/typo3/,落地页 https://{sitename}.ddev.site/,文档 https://docs.{sitename}.ddev.site/。每个版本通过 additional_hostnames 获得 vhost(/var/www/html/v{VERSION})。凭据为 admin / Joh316!!。容器优先级:存在 .ddev/ 用 ddev exec;存在 docker-compose.yml 用 docker compose exec;无容器才用系统工具,并使用项目配置的 PHP。快速开始:ddev start && ddev install-all(全部版本),ddev install-v14(v14.3 LTS),ddev install-v13(v13.4 LTS)。无 DDEV 时(CI、容器、agent harness),读取 .ddev/config.yaml 与 .ddev/commands/,再执行 scripts/provision-without-ddev.sh --extension . --serve;该发行版不含 .htaccess,/typo3/ 返回 200 而子路由 404。容器内编辑用 docker cp 拷入后 ddev exec,不用 heredoc 或 php -r。
适用场景:本地 TYPO3 开发、多版本兼容测试、后端访问与验证。
限制:URL 必须按上述规则推导,不得从目录列表推断;不同 TYPO3 版本在 setup、激活、composer.json、主题、Fluid、CKEditor 上存在差异(如 v14.3 要求 composer.json、使用 Camino 主题与 Fluid 5.x strict)。安装后验证应检查实际结果(如 /typo3/login 返回 200),而非仅看状态。其余细节见 references/ 下对应文档。