Symfony 中设置路由的核心是将 URL 映射到控制器方法,推荐使用注解方式,需启用 SensioFrameworkExtraBundle、配置 annotations: true 和 annotation 类型路由加载,在控制器方法上用 @Route 声明路径、方法、约束与默认值,参数自动注入,通过 debug:router 等命令调试,修改后需清缓存。

在 Symfony 中设置路由,核心是把 URL 请求映射到对应的控制器方法。默认使用注解(Annotations)或 YAML/PHP 配置方式,推荐从注解入手,直观且开发效率高。
启用注解路由
确保已安装并启用了 SensioFrameworkExtraBundle(Symfony 5.4+ 默认集成),并在配置中开启注解支持:
- 检查
config/packages/framework.yaml是否有annotations: true - 确认
config/routes.yaml包含加载注解路由的配置,例如:
controllers:
resource: ../../src/Controller/
type: annotation
在控制器中定义路由
在 Controller 类的方法上方用 @Route 注解声明路径、方法和名称:
-
@Route("/blog", name="blog_list")→ GET 请求匹配/blog -
@Route("/blog/{id}", name="blog_show", requirements={"id"="\d+"})→ 匹配/blog/123,限制 id 必须为数字 -
@Route("/blog/new", name="blog_new", methods={"GET","POST"})→ 同时支持两种请求方法
参数会自动注入到方法形参中,如 public function show($id) 中的 $id 就是 URL 中的值。
立即学习“PHP免费学习笔记(深入)”;
系统介绍:YIXUNCMS中专专版是易迅软件工作室在中秋节来临之即推出的专题模板建站系统,使用增强版后台管控系统,板板设计符合节日特点。易迅软件工作室恭祝全国人民中秋快乐。特别提示:由于网站页面的不同设计,部分后台功能未在前端进行体现。系统特点:1、采用目前流行的PHP语言编写,底层采用超轻量级框架作为系统支撑;2、页面布局使用DIV+CSS技术,遵循WEB标准,及大提高页面的浏览速度;3、使用应
生成和调试路由
命令行工具能帮你验证和查看所有路由:
-
php bin/console debug:router→ 列出全部已注册路由及名称 -
php bin/console debug:router blog_show→ 查看某条路由的详细信息(路径、方法、默认值等) -
php bin/console router:match /blog/42→ 模拟匹配,看哪个路由响应该 URL
路由参数与默认值
可为占位符设默认值或可选性:
-
@Route("/blog/{page}", defaults={"page"=1})→ 访问/blog等价于/blog/1 -
@Route("/blog/{slug}", requirements={"slug"="[a-z0-9-_]+"})→ 自定义正则约束 - 多个参数直接写在路径里,如
/blog/{category}/{id},方法签名对应接收$category和$id
基本上就这些。注解方式简洁直接,适合大多数场景;YAML 或 PHP 文件方式更适合集中管理或复杂条件路由。注意别忘了清除缓存:php bin/console cache:clear,尤其改完路由后。










