Symfony控制器怎么绑定路由-php教程-PHP中文网

Symfony控制器方法必须通过路由显式绑定，否则404；#[Route]注解是最直接方式，路径、名称、方法、约束均写在方法上方，编译期注册为路由规则。

symfony控制器怎么绑定路由

控制器方法必须通过路由配置显式绑定，否则访问对应 URL 会直接 404 —— Symfony 不会自动扫描控制器或按命名约定映射。

在控制器方法上方加 #[Route]，路径、名称、HTTP 方法、参数约束都写在里面。Symfony 在容器编译期读取这些注解并注册为路由规则。

#[Route('/blog/{id}', name: 'blog_show')]：最简形式，GET 请求匹配，$id 自动注入到方法参数
#[Route('/blog/{id}', methods: ['GET', 'HEAD'])]：显式限定允许的 HTTP 方法，避免 POST 意外触发
#[Route('/blog/{id}', name: 'blog_show')]：正则内联写法，等价于 requirements={"id"="\d+"}，更紧凑
多个同名路由（如带 locale 和不带 locale）不能共用 name，否则 debug:router 会报错或覆盖

常见现象是改完注解却仍 404，或 php bin/console debug:router 列表里完全没出现新路由。

确认 config/packages/framework.yaml 中有 annotations: true
确认 config/routes.yaml 包含注解加载配置：controllers: { resource: '../../src/Controller/', type: 'annotation' }
改完路由后必须运行 php bin/console cache:clear，开发环境也缓存路由定义

路径里的占位符（如 {id}、{slug}）会按名字自动绑定到方法参数，类型声明可选但推荐加上。

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

public function show(int $id): Response：类型声明让 PHP 运行时自动转换字符串为 int，失败则抛 RuntimeException
public function show(string $slug, ?string $category = null)：可选参数需显式设默认值，否则路由匹配成功但调用时报“Missing argument”
不要在方法签名里写 $request 又写 $id 却漏掉 Request 类型提示 —— use Symfony\Component\HttpFoundation\Request; 必须存在，否则 DI 容器无法注入

不冲突，但加载顺序决定优先级。Symfony 默认按 config/routes/*.yaml → config/routes.yaml → 注解的顺序合并路由。后面加载的同名路由会覆盖前面的。

如果在 config/routes.yaml 里写了 blog_list: path: /blog，又在控制器里用 #[Route('/blog', name: 'blog_list')]，后者会赢
YAML 方式更适合集中管理全局前缀、host 条件或复杂条件路由；注解更适合单个控制器内聚维护
自定义路由加载器（比如从数据库读）必须返回 Symfony\Component\Routing\RouteCollection 实例，不能只 return []

最容易被忽略的是：路由匹配发生在控制器执行之前，所有参数注入、类型转换、约束校验都由 Router 组件完成 —— 如果你在控制器里手动解析 $request->getPathInfo()，就绕过了整个机制，也失去了自动验证和本地化支持。