Symfony 6.2+ 推荐使用 #[Route] 属性配置路由，路径须以/开头，name建议显式声明；参数用{}包裹，requirements设类型约束；methods限制HTTP方法，host限定域名，condition支持EL表达式；类级Route可设路径前缀，方法级name必填且覆盖类级。
Route Attribute 基本写法（PHP 8+）
Symfony 6.2+ 官方推荐用 #[Route] 替代 YAML/XML/PHP 数组配置，前提是项目已启用 PHP 8 属性支持且安装了 symfony/attribute（通常随框架自动引入）。
最简写法就是直接在控制器方法上加属性：
#[Route('/blog', name: 'app_blog_index')]
public function index(): Response
{
// ...
}
注意两点：路径必须以 / 开头；name 参数虽可省略，但强烈建议显式声明——否则生成 URL 时会报 Unable to generate a URL for the named route "xxx" 错误。
带参数和约束的 Route Attribute 写法
动态路由参数用花括号包裹，类型约束和正则限制通过 requirements 指定，避免运行时匹配失败后抛出 No route found for "GET /blog/abc" 这类模糊错误。
-
id参数强制为数字：#[Route('/blog/{id}', requirements: ['id' => '\d+'])] - 同时约束多个参数：
#[Route('/blog/{slug}-{id}', requirements: ['id' => '\d+', 'slug' => '[a-z0-9\-]+'])] - 可选参数需设默认值（PHP 层面）：
#[Route('/blog/{page}')] public function list(?int $page = 1)，此时page在 URL 中可省略
别漏掉 requirements 的数组语法——写成字符串（如 requirements: 'id: \d+'）会静默失效，路由仍能注册，但约束不生效。
HTTP 方法、主机名与条件限制
用 methods 限定请求方式，比在控制器里手动判断 $request->isMethod('POST') 更早拦截，减少不必要的逻辑执行：
#[Route('/api/users', methods: ['POST'], name: 'api_user_create')]
多方法支持写成数组：methods: ['GET', 'HEAD']；只写一个字符串（如 methods: 'GET'）也合法，但统一用数组更稳妥。
主机名限制用 host，比如管理后台只响应 admin.example.com：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
#[Route('/dashboard', host: 'admin.example.com')]
复杂条件（如环境判断）得用 condition，例如仅在 debug 模式下暴露调试路由：
#[Route('/_debug', condition: "context.getEnvironment() == 'dev'")]
condition 是 EL 表达式，不能写 PHP 代码；变量名必须严格匹配 Symfony 表达式语言文档里的上下文对象（如 context, request）。
嵌套路由前缀与控制器类级 Attribute
避免每个方法都重复写相同路径前缀，可在控制器类上用 #[Route] 统一声明：
#[Route('/admin')]
class AdminController
{
#[Route('/users', name: 'admin_user_list')]
public function list() { /* ... */ }
<pre class="brush:php;toolbar:false;">#[Route('/users/{id}/edit', name: 'admin_user_edit')]
public function edit(int $id) { /* ... */ }
}
此时两条路由实际路径分别是 /admin/users 和 /admin/users/{id}/edit。注意：类级 #[Route] 的 name 会被忽略，必须在方法上单独定义；若类和方法都有 requirements，以方法级为准。
容易被忽略的是——类级前缀末尾是否加 / 会影响拼接结果：#[Route('/admin')] 和 #[Route('/admin/')] 在方法路径为 /users 时，最终都是 /admin/users，斜杠自动归一化，不用刻意对齐。
