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免费学习笔记(深入)”;
命令行工具能帮你验证和查看所有路由:
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,尤其改完路由后。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号