如何将Easy Admin生成的URL优化为用户友好格式？

问题场景 #

我用Easy Admin搭建了面向普通用户的自定义仪表盘（非后台管理系统），当前生成的URL是带大量参数的长格式：

/dashboardcrudAction=index&crudControllerFqcn=App%5CController%5CCrud%5CThemeCrudController&menuIndex=0&status_id=1&submenuIndex=-1

希望优化为用户友好的REST风格URL：

/dashboard/Post
/dashboard/Post/2

实现步骤 #

1. 配置自定义路由 #

可以通过两种方式配置友好路由：

方式一：在Easy Admin配置文件中定义

修改config/packages/easy_admin.yaml，添加自定义路由规则，指定路由路径、对应控制器和动作：

easy_admin:
  routes:
    prefix: '/dashboard' # 基础前缀
    custom_routes:
      # 列表页路由
      - { name: 'dashboard_post_index', path: '/Post', controller: 'App\Controller\Crud\ThemeCrudController', action: 'index' }
      # 详情页路由（带ID参数）
      - { name: 'dashboard_post_show', path: '/Post/{id}', controller: 'App\Controller\Crud\ThemeCrudController', action: 'show' }

方式二：直接在Symfony路由文件中定义

修改config/routes.yaml，添加优先级更高的自定义路由（会覆盖Easy Admin默认路由）：

dashboard_post_index:
  path: /dashboard/Post
  controller: App\Controller\Crud\ThemeCrudController::index

dashboard_post_show:
  path: /dashboard/Post/{id}
  controller: App\Controller\Crud\ThemeCrudController::show

2. 替换链接生成逻辑 #

不再使用Easy Admin默认的crudUrl生成方法，改用Symfony的路由生成器：

Twig模板中生成链接

{# 生成列表页链接 #}
<a href="{{ path('dashboard_post_index') }}">文章列表</a>

{# 生成单篇文章详情页链接 #}
<a href="{{ path('dashboard_post_show', { id: post.id }) }}">查看文章</a>

控制器中生成链接

注入UrlGeneratorInterface来生成URL：

use Symfony\Component\Routing\Generator\UrlGeneratorInterface;

public function someAction(UrlGeneratorInterface $urlGenerator): Response
{
    // 生成列表页URL
    $listUrl = $urlGenerator->generate('dashboard_post_index');
    // 生成详情页URL
    $detailUrl = $urlGenerator->generate('dashboard_post_show', ['id' => 2]);
    
    // ...
}

3. 处理额外参数（如status_id） #

如果原URL中的status_id这类过滤参数需要保留，可以将其整合到路由中：

• 可选1：作为查询参数（如/dashboard/Post?status=1），直接在控制器中通过$request->query->get('status')获取
• 可选2：作为路由片段（如/dashboard/Post/status/1），需要添加对应路由规则：

dashboard_post_index_filtered:
  path: /dashboard/Post/status/{statusId}
  controller: App\Controller\Crud\ThemeCrudController::index

然后在控制器方法中接收参数：

public function index(Request $request, int $statusId = null): Response
{
    // 根据$statusId过滤数据
    // ...
}

4. 验证路由生效 #

清除Symfony缓存后，访问自定义URL，确认能正常对应到Crud控制器的对应动作，同时原带参数的URL会被覆盖（或失效，根据路由优先级）。

内容的提问来源于stack exchange，提问作者user10286245