Agent skill · software engineering · affaan-m
laravel-patterns
Laravel架构模式、路由/控制器、Eloquent ORM、服务层、队列、事件、缓存以及用于生产应用的API资源。
Why this skill is useful
Provides specific architectural patterns and best practices for building scalable Laravel applications that the AI wouldn't reliably generate on its own.
What it needs
About 3k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
Laravel 开发模式 适用于可扩展、可维护应用的生产级 Laravel 架构模式。 适用场景 构建 Laravel Web 应用或 API 构建控制器、服务和领域逻辑 使用 Eloquent 模型和关系 使用资源和分页设计 API 添加队列、事件、缓存和后台任务 工作原理 围绕清晰的边界（控制器 -> 服务/操作 -> 模型）构建应用。 使用显式绑定和作用域绑定来保持路由可预测；同时仍强制执行授权以实现访问控制。 倾向于使用类型化模型、转换器和作用域来保持领域逻辑一致。 将 IO 密集型工作放在队列中，并缓存昂贵的读取操作。 将配置集中在 config/ 中，并保持环境配置显式化。 示例 项目结构 使用具有清晰层级边界（HTTP、服务/操作、模型）的常规 Laravel 布局。 推荐布局 控制器 -> 服务 -> 操作 保持控制器精简。将编排逻辑放在服务中，将单一职责逻辑放在操作中。 路由与控制器 为了清晰起见，优先使用路由模型绑定和资源控制器。 路由模型绑定（作用域） 使用作用域绑定来防止跨租户访问。 嵌套路由和绑定名称 保持前缀和路径一致，避免双重嵌套（例如 conversation 与 conversations）。 使用与绑定模型匹配的单一参数名（例如，{conversation} 对应 Conversation）。 嵌套时优先使用作用域绑定以强制执行父子关系。 如果希望参数解析为不同的模型类，请定义显式绑定。对于自定义绑定逻辑，请使用 Route::bind() 或在模型上实现 resolveRouteBinding()。 服务容器绑定 在服务提供者中将接口绑定到实现，以实现清晰的依赖关系连接。 Eloquent 模型模式 模型配置 自定义转换器与值对象 使用枚举或值对象进行严格类型化。 预加载以避免 N+1 问题 用于复杂筛选的查询对象 全局作用域与软删除 使用全局作用域进行默认筛选，并使用 SoftDeletes 处理可恢复的记录。 对于同一筛选器，请使用全局作用域或命名作用域中的一种，除非你打算实现分层行为。 用于可重用筛选器的查询作用域 用于多步更新的数据库事务 数据库迁移 命名约定 文件名使用时间戳：YYYYMMDDHHMMSScreateuserstable.php 迁移使用匿名类（无命名类）；文件名传达意图 表名默认为 snakecase 且为复数形式 迁移示例 表单请求与验证 将验证逻辑放在表单请求中，并将输入转换为 DTO。 API 资源 使用资源和分页保持 API 响应一致。 事件、任务和队列 为副作用（邮件、分析）触发领域事件 使用队列任务处理耗时工作（报告、导出、Webhook） 优先使用具有重试和退避机制的幂等处理器 缓存 缓存读密集型端点和昂贵查询 在模型事件（创建/更新/删除）时使缓存失效 缓存相关数据时使用标签以便于失效 配置与环境 将机密信息保存在 .env 中，将配置保存在 config/.php 中 使用按环境配置覆盖，并在生产环境中使用 config:cache
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/laravel-patterns--2fbb11