SuperAPI AI 工具集

ddev

编程与开发

查看项目

更新于 10-16 06:47

技能介绍

用途:在 Craft CMS 项目中使用 DDEV 搭建和管理本地容器化开发环境,覆盖项目初始化、配置、数据库导入导出、插件开发与调试。触发本技能时建议同时加载 craftcms(涉及 Craft CLI 时)与 craft-php-guidelines(涉及代码质量工具时)。

主要能力:支持项目启动停止、SSH、日志、数据库导入导出、Xdebug、Mailpit 邮件捕获、ddev share 临时公开站点、add-on 安装(如 ddev add-on get ddev/ddev-redis)、自定义命令、Chrome DevTools MCP 浏览器调试。

使用方式:优先使用 ddev 简写命令而非 ddev exec,例如 ddev composer install、ddev craft up、ddev npm install。新建项目可使用 ddev config --project-type=craftcms --docroot=web 后 ddev start、ddev composer create-project craftcms/craft。Craft CMS 项目类型在 .ddev/config.yaml 中设置 type: craftcms,并自动注入 CRAFT_DB_* 等环境变量。操作数据库优先用 Craft CLI(如 ddev craft users/list-admins),无 CLI 等价命令时才用 ddev mysql。

适用场景:Craft CMS 本地开发、插件本地路径仓库开发(需将宿主路径挂载进容器)、插件测试套件运行、前后端模板与控制面板调试、认证流程与视觉回归检查。

限制与注意事项:ddev composer global require 在容器内重启即失效;nodejs_version 需配合 ddev npm 在容器内运行;修改 .ddev/config.yaml 后需 ddev restart;多数据库导入需显式 --target-db;自定义命令不要加 #ddev-generated,否则更新时会被覆盖;宿主与容器 PHP 版本不一致会导致 vendor 依赖校验失败。资料未提供收费、价格或平台限制信息。