Laravel Folio 命名路由指南name() 与 route() 助手如何生成优雅 URL【免费下载链接】folioPage based routing for Laravel.项目地址: https://gitcode.com/gh_mirrors/foli/folioLaravel Folio 是一个为 Laravel 提供基于页面文件的路由Page based routing的官方组件你只需要把.blade.php文件放到pages目录它就能自动变成路由。而本文要讲的是它最实用的进阶能力之一——命名路由如何用页面顶部的name()元数据给路由命名再用 Laravel 原生的route()助手函数反向生成 URL彻底告别在模板里手写/posts/123这样的硬编码链接。 读完本文你能做到给任意 Folio 页面注册一个命名路由如posts.show用route(posts.show, [...])一行代码生成 URL理解路由缓存与folio:list命令如何帮你管理这些命名路由为什么要给 Folio 页面起名字在 Laravel 传统写法中每个路由都要在routes/web.php里注册然后用route(name)按名字取 URL。Folio 的思路是路由藏在文件名里名字藏在页面顶部。?php use function Laravel\Folio\name; name(posts.show);只要把上面这个?php ?块放在pages/posts/[Post].blade.php的文件最顶部Folio 就为这条路由注册了名字posts.show。之后在任意 Blade 模板、Controller 或邮件里都可以这样生成 URLroute(posts.show, [post $post]) // /posts/42这就是优雅 URL的含义URL 结构只存在于文件名中一处改名、改目录时所有route()调用自动跟着变不会出现链接失效。name()等页面元数据函数定义在 functions.php 中返回值是一个 PageOptions 对象方便继续链式调用middleware()、render()等。命名约定沿用 Laravel 的点号风格Folio 官方技能文档resources/boost/skills/folio-routing/SKILL.blade.php建议使用与原生路由一致的资源.动作风格文件名推荐路由名pages/dashboard.blade.phpdashboardpages/posts/index.blade.phpposts.indexpages/posts/[Post].blade.phpposts.showpages/admin/products.blade.phpadmin.products这样团队里任何人看到route(posts.show)都能立刻猜到它指向哪个页面。⚠️一个容易踩的坑name()、middleware()等元数据必须写在页面最顶部的原生?php ?块里。如果写进 Blade 的php ... endphp指令Folio 的扫描器只会静默忽略——路由名永远不会注册folio:list里也不会显示。元数据的解析入口在 InlineMetadataInterceptor最终存储到 Metadata 这个简单容器类中。route() 助手从名字生成 URL 的完整流程当你调用route(posts.show, [post $post])时Folio 的 FolioRoutes 类会接管 URL 生成流程分为三步查名字在已注册或缓存的路由表中找到posts.show拿到它的挂载目录、视图路径和基础 URI填参数把文件名里的方括号段如[Post]、[User:email]逐个替换成你传入参数的值模型会自动取路由键getRouteKey()或指定列组装 URL拼上挂载基础路径交给 Laravel 的url()-toRoute()生成最终地址。几个实用细节参数必须是带键的数组route(posts.show, [post $post])✅直接route(posts.show, $post)❌ 会抛TypeError。键名与文件名对应[Post:slug].blade.php的键仍是post:slug只决定按哪一列解析大小写不敏感内部做了Str::camel()归一化。缺少参数会快速报错忘记传post时抛出 UrlGenerationException提示 Missing required parameter名字根本不存在则抛出RouteNotFoundException。第三个参数控制绝对路径route(posts.show, $params, true)生成http://localhost/posts/42省略或传false得到相对路径/posts/42。{{-- 在 Blade 模板中 --}} a href{{ route(posts.show, [post $post]) }}查看文章/a模型绑定也能用于 URL 生成文件名支持模型绑定如pages/users/[User:email].blade.php。生成 URL 时直接传模型实例Folio 会自动取出email列的值填入路径——这与原生Route::get(/posts/{user:email})的行为完全对等对应用例见 tests/Feature/NameTest.php。路由缓存让 route() 在生产环境更快route()生成 URL 时需要名字 → 文件的映射。生产环境部署时执行php artisan route:cacheFolio 会把所有已命名路由扫描后持久化到缓存文件逻辑见 FolioRoutes::persist()。之后route()直接从缓存读取无需再扫描pages目录。 注意只有写了name()的页面才会进入路由缓存匿名页面不受影响。folio:list一眼看清所有命名路由Folio 内置folio:list命令实现于 ListCommand输出表格包含Domain / Method / URI / Name / View五列其中Name 列显示的就是你注册的name(...)值并且以name › view的形式展示见 formatActionForCli()php artisan folio:list --nameposts # 按名字过滤改完目录结构后跑一遍这个命令是验证命名路由是否按预期注册最快的方式。挂载与自定义前缀下的命名路由如果你的页面挂在非默认目录下例如通过Folio::path()或Folio::uri(/user)-path(...)注册多个挂载点见 FolioManager::route()name()与route()依然照常工作基础 URI 前缀会拼在生成的路径前面Folio::domain()设置的自定义域名也会体现在绝对 URL 中。常见问题速查症状原因与解法route(x)提示Route not found页面顶部没有name(x)或写在了php里被忽略Missing required parameter [post]route()的数组键名与文件名方括号段不匹配TypeError传了单个模型而非[post $model]数组folio:list看不到名字检查元数据块是否在文件最顶部且为原生?php ?小结name()写在 Blade 页面最顶部的原生 PHP 块中一个字符串就完成命名路由注册route(posts.show, [post $post])即可反向生成 URL模型绑定、自定义列、绝对路径全部支持用route:cache加速生产环境用folio:list审计所有路由名。掌握这两行仪式你的 Laravel 项目就能在 Folio 的简洁文件结构之上保留 Laravel 命名路由的全部便利。✨【免费下载链接】folioPage based routing for Laravel.项目地址: https://gitcode.com/gh_mirrors/foli/folio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考