SuperAPI AI 工具集

laravel-patterns

编程与开发

查看项目

更新于 10-15 21:09

技能介绍

用途:为 Laravel 应用与 API 提供生产级架构模式,帮助组织控制器、服务与领域逻辑,并处理 Eloquent 模型、API 资源、队列、事件与缓存。

主要能力:按清晰边界分层(控制器 -> 服务/动作 -> 模型);使用显式绑定与作用域绑定保持路由可预测,并强制授权;采用类型化模型、casts 与查询作用域统一领域逻辑;将 IO 密集工作放入队列,缓存昂贵读取;配置集中在 config/* 并显式区分环境。

使用方式:推荐目录结构包含 app/Actions、Services、Http/Controllers、Http/Requests、Http/Resources、Models、Policies、Jobs、Events 等。控制器保持精简,编排放服务,单一用途逻辑放动作。路由使用 apiResource 与 auth:sanctum 中间件,嵌套路由用 Route::scopeBindings() 防止跨租户访问,必要时用 Route::model() 或 resolveRouteBinding() 自定义绑定。服务容器在 AppServiceProvider 中 bind 接口到实现。Eloquent 使用 fillable、casts、枚举/值对象、Attribute 自定义转换、with() 预加载避免 N+1、查询对象封装复杂过滤、全局作用域与 SoftDeletes、DB::transaction 处理多步更新。迁移使用匿名类与时间戳文件名。验证放 FormRequest 并转换为 DTO。API 响应统一用 Resource 与分页 meta。事件用于副作用,队列作业处理慢任务并保持幂等与重试退避。缓存读多写少端点,模型事件触发失效,关联数据用 tags。

适用场景:构建 Laravel Web 应用或 API、设计资源与分页、添加队列/事件/缓存/后台任务。

限制:资料未提供具体版本要求、性能数据、收费信息或安装命令;示例代码仅作模式参考,需按项目实际调整。