SuperAPI AI 工具集

drupal-expert

编程与开发

查看项目

更新于 10-16 00:03

技能介绍

用途:为 Drupal 10/11 开发提供专家级指导,覆盖模块、主题、钩子、服务、配置与迁移等场景。

主要能力:强调“先调研”原则,建议先在 drupal.org/project/project_module 查找现有贡献模块,评估其 Drupal 10/11 兼容性、安全覆盖、最近提交、使用站点数、问题队列响应等,并考虑 Drupal Recipe(10.3+)或给现有模块打补丁,确认无合适方案后再写自定义代码。

编码规范:类使用 PSR-4 自动加载,遵循 Drupal/DrupalPractice 的 PHPCS 标准,函数与类需 docblock;面向用户字符串用 t(),占位符区分 @variable、%variable、:variable。

依赖注入:类中不用 \Drupal::service(),改为构造函数注入,服务在 *.services.yml 定义;表单与控制器用 ContainerInjectionInterface,插件用 ContainerFactoryPluginInterface。

钩子与事件:OOP 钩子适合修改核心/贡献模块行为、遵循核心约定、需控制钩子顺序时;事件订阅者适合集成第三方库(PSR-14)、打包多项定制、与 Commerce 等事件密集模块协作。

安全:不信任用户输入,使用参数化数据库查询,正确检查访问权限,渲染用 #markup 配合 Xss::filterAdmin() 或 #plain_text,并参考 OWASP Top 10 的 Drupal 风险。

测试:生产代码需测试。单元测试用 UnitTestCase,内核测试用 KernelTestBase,功能测试用 BrowserTestBase,JS 功能测试用 WebDriverTestBase;测试文件放在 tests/src 下的 Unit、Kernel、Functional 目录。运行示例:./vendor/bin/phpunit modules/custom/my_module。

CLI 优先:用 Drush 生成器搭建脚手架,如 drush generate module、drush generate controller、drush generate form-config、drush generate plugin:block、drush generate service、drush generate event-subscriber、drush generate entity:content 等;内容类型与字段用 CLI 创建,如 drush field:create node article --field-name=field_subtitle,避免手写 node.type..yml、field.field..yml 等配置。生成后用 drush config:export -y 导出配置。测试数据可用 drush devel-generate:content 50 --bundles=article,page --kill。

自动化:Drush 生成器默认交互,可用 --answers 传 JSON、顺序 --answer 标志、-vvv --dry-run 发现提示、-y 接受默认值。DDEV 下加 ddev 前缀,Docker Compose 下用 docker compose exec php。

限制:资料未提供该技能的安装方式、收费、平台支持范围与效果数据,暂未提供。