用途:面向 Drupal 模块开发,帮助编写 routing.yml 路由定义、控制器以及 URL 和链接生成逻辑,覆盖普通页面、带参数路由、后台路由和设置表单路由。
主要能力:
- 在 my_module.routing.yml 中定义路由,使用 path、defaults(_controller、_title)、requirements(_permission)等键。
- 路由参数:路径如 '/items/{item_id}',在 requirements 中用正则约束参数(如 item_id: '\d+'),并通过 _title_callback 指定标题回调。
- 后台路由与设置表单:path 以 /admin/config 开头,defaults 使用 _form 指向 SettingsForm 类,requirements 使用 _permission 控制访问。
- 实体 upcasting:在 options.parameters 中声明参数类型(如 node: type: entity:node),并使用 _entity_access 做实体访问控制。
- 控制器:继承 ControllerBase,方法返回可渲染数组;可接收路由参数(如 int $item_id),并使用 $this->t() 翻译和 #cache 缓存上下文。
- URL 与链接:使用 Url::fromRoute()(可带参数、absolute 选项)、Url::fromUserInput() 生成 URL,使用 Link::fromTextAndUrl()->toRenderable() 生成链接。
使用方式:按示例在模块的 routing.yml 中声明路由,在 src/Controller 下创建控制器并实现相应方法,在需要时通过 Url 和 Link API 生成跳转地址。
限制与说明:资料仅涉及路由、控制器、参数、权限、标题回调、实体 upcasting 与 URL/链接生成,未说明版本要求、依赖模块、安装步骤或其它收费、平台、效果等信息。