关于 laravel-architecture
为 Laravel 应用选择和组织架构模式的参考技能，涵盖领域逻辑、数据传输、状态转换、外部集成与项目结构。通过决策流程和示例帮助开发者确定模式及其适用场景。
主要功能
- 01用 Action 承载领域逻辑
- 02用 DTO 传递数据
- 03通过决策流程选择模式
- 04组织文件与命名空间
- 05遵循开发和部署清单
适用场景
- 01为复杂状态转换选择模式
- 02规划外部 API 集成结构
- 03将 HTTP 控制器与领域逻辑分离
- 04安排功能开发与部署步骤
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/laravel-architecture确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/checklist.mddecisions.mdexamples.mdpatterns.mdphilosophy.mdstructure.md详细介绍
Laravel 架构
Laravel 应用的高级架构指南。
核心概念
philosophy.md - 基本原则：
- 首要原则是声明式代码
- 严格分离关注点
- 类型安全优先
- 所有核心架构原则
patterns.md - 模式概览：
- 使用 Action 处理领域逻辑
- 使用 DTO 传输数据
- 使用状态机处理复杂状态
- 使用 Service 集成外部服务
- 使用工作流处理多步骤流程
- 使用值对象表示领域值
decisions.md - 模式选择：
- 何时使用各个模式
- 决策流程图
- 架构权衡
- 常见场景
structure.md - 目录结构：
- 完整的项目组织结构
- 文件放置规则
- 命名空间约定
- Web 与 API 的区别
examples.md - 参考实现：
- 完整的可运行示例
- 端到端工作流
- 实际应用模式
checklist.md - 实施检查清单：
- 设置任务
- 功能开发工作流
- 生产环境部署步骤
核心原则
- Action 包含领域逻辑 - 业务逻辑位于可调用的 Action 类中
- 绝不传递原始类型 - 始终使用 DTO 传输数据
- 精简的 HTTP 层 - 控制器只处理 HTTP 相关事务
- 自定义查询构建器 - 使用类型安全的查询，而非作用域
- 严格类型检查 - 在每个文件中使用
declare(strict_types=1)
快速决策树
需要……
- 处理领域逻辑？ → Action
- 传输数据？ → DTO
- 验证用户输入？ → Form Request
- 简单状态字段？ → Enum
- 复杂状态转换？ → 状态机
- 外部 API？ → 使用 Saloon 的 Service
- 后台处理？ → Job（委托给 Action）
如需详细指南，请阅读 decisions.md 中的决策流程图。
评论
支持 Markdown