SuperAPI AI 工具集

wayfinder-development

编程与开发

查看项目

更新于 10-16 03:49

技能介绍

用途:该技能面向 Laravel Wayfinder,它为 Laravel 控制器和路由自动生成带类型的函数,供前端代码调用;当前端代码需要引用 Laravel 路由时使用。

主要能力:生成控制器与路由的类型化函数;支持命名导入、路由对象、URL 字符串、按 HTTP 方法调用(get/post/patch/delete)、表单属性与查询参数;可与 Inertia 的 Form 组件配合。

使用方式:路由变更后若未安装 Vite 插件,运行 php artisan wayfinder:generate --no-interaction;需要表单辅助时加 --with-form 参数,如 php artisan wayfinder:generate --with-form --no-interaction。导入推荐使用命名导入,例如从 @/actions/App/Http/Controllers/PostController 导入 show、store、update,或从 @/routes/post 导入并重命名。调用 show(1) 返回 { url: "/posts/1", method: "get" };show.url(1) 返回 "/posts/1";store.form() 返回 { action: "/posts", method: "post" };show(1, { query: { page: 1 } }) 返回 "/posts/1?page=1"。在 Inertia 中可用 <Form {...store.form()}> 形式。

验证:运行生成命令重新生成路由,检查 TypeScript 导入能否正确解析,并核对路由 URL 与预期路径一致。

限制与常见问题:使用默认导入而非命名导入会破坏 tree-shaking;路由变更后忘记重新生成;路由模型绑定未使用类型安全的参数对象。详细模式与文档建议使用 search-docs 查询。