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;
<p>use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\Routing\Annotation\Route;</p><p>class BlogController extends AbstractController
{
/**</p><ul><li>@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()
{
// 显示表单
}
<pre class="brush:php;toolbar:false;">/**
* @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() { ... }
<pre class="brush:php;toolbar:false;">/**
* @Route("/{id}/edit", name="admin_blog_edit")
*/
public function edit($id) { ... }}
这样，index对应/admin/blog，edit对应/admin/blog/{id}/edit。
基本上就这些。注解路由让路径定义更贴近代码逻辑，适合中小型项目快速开发。只要记得开启注解支持，合理使用name、requirements和methods，就能高效管理应用路由。
