用途:在 DDEV 环境中搭建和运行 TYPO3 项目,并执行相关 ddev 命令(start、stop、restart、describe、exec 等)及浏览器访问后端。
主要能力:多版本 TYPO3(11/12/13/14)安装与设置;按名字生成 DDEV URL;数据库选择(MariaDB 10.11 默认、SQLite、PostgreSQL 16、MySQL 8.0);PHP 版本管理(config.yaml 中 php_version,如 8.3);可选服务(Valkey 8 默认或 Redis 7、Ofelia 调度器);扩展命名规范(Composer 用连字符、TYPO3 key 用下划线);安装后验证与故障排查。
URL 方案(重要):切勿猜测 URL。先读 .ddev/config.yaml 的 name:,再套用子域模式:https://v{VERSION}.{sitename}.ddev.site/typo3/,例如 https://v14.my-ext.ddev.site/typo3/;落地页 https://{sitename}.ddev.site/,文档 https://docs.{sitename}.ddev.site/。每个版本通过 additional_hostnames 拥有 Apache vhost(/var/www/html/v{VERSION}),不要依据目录列表推断 URL。凭据:admin / Joh316!!。
使用方式:优先容器——存在 .ddev/ 用 ddev exec;存在 docker-compose.yml 用 docker compose exec;无容器才用系统工具,并使用项目配置的 PHP。容器内编辑文件用 docker cp 拷入再 ddev exec,不要用 heredoc 或 php -r。快速开始:ddev start && ddev install-all(所有版本),或 ddev install-v14(v14.3 LTS,默认/金标准)、ddev install-v13(v13.4 LTS)。其他命令:ddev status、ddev describe、ddev exec -d /var/www/html/v13 vendor/bin/typo3 extension:list --active、ddev generate-makefile、ddev generate-index、ddev docs、ddev xdebug on。
版本差异:setup 命令 v12 为 install:setup --use-existing-database,v13/v14 为 setup;激活 v12 自动(Composer),v13/v14 用 extension:setup;composer.json v12/v13 可选、v14 必填(classic mode,#108310);默认主题 v12/v13 为 bootstrap-package,v14 为 Camino(#108539);Fluid v12 为 2.x、v13 为 4.x、v14 为 5.x strict(#108148);CKEditor 分别为 41–42、41–42、47。
适用场景:TYPO3 扩展开发、DDEV 本地环境搭建、多版本测试与后端访问。
限制:资料未提供收费、价格、平台支持范围等细节;命令与版本行为可能随上游变化,使用前请核对官方文档。