New in EasyAdmin: Pretty URLs

easyadmin 最受欢迎的功能刚刚在 4.14.0 版本中推出。

从第一天开始，easyadmin 就使用查询字符串参数来传递必要的
渲染后端页面的信息。这种方法创建的 url 如下：

https://example.com/admin?crudaction=edit&crudcontrollerfqcn=app%5ccontroller%5cadmin%5cpostcrudcontroller&entityid=3874

虽然这个 url 格式很难看，但它很实用。某些浏览器，例如 safari，甚至
默认隐藏大部分url，只显示主机名，所以影响
最终用户很少。

但是，从今天开始，easyadmin 会生成更清晰的 url，如下所示：

https://example.com/admin/post/3874/edit

除了是最受欢迎的功能之外，我们还针对
实施了此更改 两个主要原因：

• 旧的、丑陋的 url 泄露了应用程序的内部详细信息，例如 crud 控制器的命名空间。这通常很好，因为大多数后端 不与外部用户共享 url，但这并不理想。
• 使用 adminurlgenerator 类构建这些丑陋的 url 非常麻烦。现在， 您可以使用诸如 admin_post_edit 或 admin_user_index 之类的路由名称并依赖 symfony 的内置功能可生成 url。

如何启用漂亮的 url？

此功能旨在与当前应用程序无缝协作。如果
如果您不进行任何更改，应用程序仍将使用丑陋的 url，并且
一切都会像以前一样继续进行。

如果您想立即开始使用漂亮的 url，请创建以下配置
您的应用程序中的文件：

# config/routes/easyadmin.yaml
easyadmin
    resource: .
    type: easyadmin.routes

此配置启用自定义 symfony 路由加载器，该类
在您的应用程序中自动生成路由。清除缓存（通过运行
php bin/console 缓存：清除或 rm -fr var/cache/*) 并且应用程序将
开始使用漂亮的 url。运行以下命令查看所有新生成的
路线：

php bin/console debug:router

您现在还可以更新代码以停止使用
构建后端 url adminurlgenerator 实用程序并直接使用新的路由名称：

// Before:
$this->adminUrlGenerator()
    // this is only needed if you have ore than 1 dashboard
    ->setDashboard(SomeDashboardController::class)
    ->setController(ProductCrudController::class)
    ->setAction('detail')
    ->setEntityId(321)
    ->generateUrl();

// After:
$this->router->generate('admin_product_detail', ['entityId' => 321]);

生成的路由由三部分组成：dashboard + crud + action。每个
其中可以使用新的 php 属性进行自定义 #[admindashboard],
#[admincrud] 和#[adminaction]。阅读文档以了解更多信息。

在 easyadmin 4.x 版本中，漂亮的 url 仍然是可选的，但现在丑陋的 url 是
已弃用。 从 easyadmin 5.x 开始（计划很快发布），漂亮的 url
需要。

如果您喜欢此功能并希望看到更多类似功能，请考虑
赞助 easyadmin 项目。

以上就是New in EasyAdmin: Pretty URLs的详细内容，更多请关注php中文网其它相关文章！