Symfony路由参数通过方法签名同名变量自动注入，无需手动从$request获取；需确保参数名、类型提示与路由占位符一致，并可用requirements约束格式。
控制器里直接声明参数名就能拿到
只要路由定义里有 {id}、{slug} 这类占位符，控制器方法签名中声明同名变量即可自动注入，不需要从 $request 里手动取。Symfony 在匹配路由后会把提取出的值按名称绑定到参数上。
常见错误现象：
- 写成
public function show($postId)，但路由是/blog/{id}→ 名字不匹配，$postId为null - 类型提示写错，比如
public function show(int $id)，但实际 URL 是/blog/abc→ 触发 404（除非加了requirements拦截） - 用
$request->attributes->get('id')手动取 —— 不必要，且绕过框架参数绑定机制
正确写法示例：
#[Route('/blog/{id}', name: 'blog_show')]
public function show(string $id): Response
{
// $id 已是字符串 "123"，无需额外解析
return $this->json(['id' => $id]);
}
需要类型转换？优先用路由 requirements
如果希望 $id 进入控制器前就确保是数字，别在方法里做 is_numeric() 或 filter_var() 校验，而是用路由级约束。这样非法输入会在路由匹配阶段就被拦截，避免进入控制器逻辑。
两种等效写法（Symfony 6+ 推荐属性）：
#[Route('/blog/{id}', requirements: ['id' => '\d+'])]-
#[Route('/blog/{id}')]—— 更紧凑，正则直接嵌入占位符
效果一样：/blog/abc 直接返回 404；/blog/42 才进控制器，且 $id 是字符串 "42"。如需整型，再在方法内 (int) $id 转换即可。
多个参数或可选参数怎么处理
路由支持多个占位符和默认值，对应控制器参数也必须一一对应，且可选参数要放在参数列表末尾，并设默认值。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
例如路由定义：
#[Route('/search/{category}/{page<\d+>?1}', name: 'search_list')]
对应控制器写法：
public function list(string $category, int $page = 1): Response
关键点：
-
$page必须带默认值= 1，否则调用/search/books时会报“缺少必需参数” - 类型提示
int和路由正则\d+配合，能保证$page进来就是整数，不用再校验 - 顺序不能错：路由里
{category}在前，$category就得排第一
想在服务类或事件监听器里获取当前路由参数
控制器外无法直接声明参数，得从请求属性中读取。最可靠的方式是注入 RequestStack，然后取当前主请求的 attributes：
use Symfony\Component\HttpFoundation\RequestStack;
class MyService
{
public function __construct(private RequestStack $requestStack) {}
public function getCurrentId(): ?string
{
$request = $this->requestStack->getCurrentRequest();
if (!$request) {
return null;
}
return $request->attributes->get('id'); // 对应 {id} 占位符
}
}
注意：
- 不要用
$request->query->get('id')—— 那是查询参数，不是路由参数 - 不要依赖
$_GET或$_SERVER—— 破坏可测试性，且可能拿错值 - 如果服务在 CLI 环境下运行，
getCurrentRequest()可能返回null，需判空
路由参数名大小写敏感，且必须和 #[Route] 中定义的完全一致，多一个下划线或大小写错误都会导致 get() 返回 null。
