Symfony中的路由注解通过@Route将控制器方法与URL绑定，无需YAML或XML配置。1. 使用composer require annotations安装组件；2. 在方法上用@Route("/path", name="route_name")定义路由；3. 支持动态参数如{ id }，可设默认值defaults和正则约束requirements；4. 通过methods限制HTTP方法，实现GET/POST分离或RESTful设计；5. 可在类上添加@Route设置统一前缀，简化重复路径配置。该方式直观高效，适合中小型项目快速开发。
Symfony中的路由注解（Route Annotation）是一种将控制器方法与URL路径绑定的便捷方式，它通过在控制器类的方法上添加注解来定义路由规则，无需使用YAML或XML配置文件。这种方式直观、易维护，是现代Symfony项目中常用的路由定义方法。
启用和安装路由注解
Symfony默认支持注解路由，但需要确保已安装 annotations 组件。大多数Symfony项目通过Flex安装时会自动包含该依赖。若未安装，可通过Composer添加：
composer require annotations安装后，Symfony会自动加载注解功能，你就可以在控制器中使用@Route了。
基本用法：定义简单路由
在控制器方法上方使用@Route注解，指定访问路径。例如：
namespace App\Controller;use Symfony\Bundle\FrameworkBundle\Controller\AbstractController; use Symfony\Component\Routing\Annotation\Route;
class BlogController extends AbstractController { /**
- @Route("/blog", name="blog_index")
*/
public function index()
{
return $this->render('blog/index.html.twig');
}
}
说明：
-
/blog是访问路径 -
name="blog_index"是该路由的唯一名称，用于生成URL或重定向
带参数的路由映射
你可以定义包含动态占位符的路由，比如文章ID：
/** * @Route("/blog/{id}", name="blog_show") */ public function show($id) { return new Response("查看文章ID: " . $id); }占位符
{id}会自动作为方法参数传入。你还可以设置默认值和约束：/** * @Route("/blog/{page}", name="blog_list", defaults={"page": 1}, requirements={"page": "\d+"}) */ public function list($page)
{
return new Response("当前页码: " . $page);
}
-
defaults设置参数默认值 -
requirements使用正则限制参数格式，如\d+表示只能是数字
HTTP方法限制与多方法支持
可以限定路由只响应特定HTTP方法：
/** * @Route("/blog/create", name="blog_create", methods={"GET"}) */ public function createForm() { // 显示表单 }/** * @Route("/blog/create", name="blog_save", methods={"POST"}) */ public function save() { // 处理提交 }同一个路径可绑定不同方法，实现RESTful设计。也支持多个方法：
methods={"GET", "POST"}控制器类级别路由前缀
若整个控制器共享相同路径前缀，可在类上使用
@Route作为基础路径：/** * @Route("/admin/blog") */ class AdminBlogController extends AbstractController { /** * @Route("", name="admin_blog_index") */ public function index() { ... }/** * @Route("/{id}/edit", name="admin_blog_edit") */ public function edit($id) { ... }}
这样，index对应
/admin/blog，edit对应/admin/blog/{id}/edit。基本上就这些。注解路由让路径定义更贴近代码逻辑，适合中小型项目快速开发。只要记得开启注解支持，合理使用name、requirements和methods，就能高效管理应用路由。
-
{
return new Response("当前页码: " . $page);
}
