php中文网

New in EasyAdmin: Pretty URLs

php中文网

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中文网其它相关文章!