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