laravel-architecture

Laravel 架构

Laravel 应用的高级架构指南。

核心概念

philosophy.md - 基本原则：

• 首要原则是声明式代码
• 严格分离关注点
• 类型安全优先
• 所有核心架构原则

patterns.md - 模式概览：

• 使用 Action 处理领域逻辑
• 使用 DTO 传输数据
• 使用状态机处理复杂状态
• 使用 Service 集成外部服务
• 使用工作流处理多步骤流程
• 使用值对象表示领域值

decisions.md - 模式选择：

• 何时使用各个模式
• 决策流程图
• 架构权衡
• 常见场景

structure.md - 目录结构：

• 完整的项目组织结构
• 文件放置规则
• 命名空间约定
• Web 与 API 的区别

examples.md - 参考实现：

• 完整的可运行示例
• 端到端工作流
• 实际应用模式

checklist.md - 实施检查清单：

• 设置任务
• 功能开发工作流
• 生产环境部署步骤

核心原则

1. Action 包含领域逻辑 - 业务逻辑位于可调用的 Action 类中
2. 绝不传递原始类型 - 始终使用 DTO 传输数据
3. 精简的 HTTP 层 - 控制器只处理 HTTP 相关事务
4. 自定义查询构建器 - 使用类型安全的查询，而非作用域
5. 严格类型检查 - 在每个文件中使用 declare(strict_types=1)

快速决策树

需要……

• 处理领域逻辑？ → Action
• 传输数据？ → DTO
• 验证用户输入？ → Form Request
• 简单状态字段？ → Enum
• 复杂状态转换？ → 状态机
• 外部 API？ → 使用 Saloon 的 Service
• 后台处理？ → Job（委托给 Action）

如需详细指南，请阅读 decisions.md 中的决策流程图。