Symfony路由参数怎么获取-php教程-PHP中文网

Symfony路由参数通过方法签名同名变量自动注入，无需手动从$request获取；需确保参数名、类型提示与路由占位符一致，并可用requirements约束格式。

symfony路由参数怎么获取

控制器里直接声明参数名就能拿到

只要路由定义里有 {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?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} 占位符
    }
}

注意：