用途:为 Laravel 应用提供高层架构指导,帮助开发者在决定使用哪种模式、组织代码或做结构性决策时参考。
主要能力:资料包含多个主题文件。philosophy.md 给出基础原则,如声明式代码优先、严格关注点分离、类型安全优先。patterns.md 概述模式:用 Action 承载领域逻辑、用 DTO 传输数据、用状态机处理复杂状态、用 Service 做外部集成、用 Workflow 处理多步流程、用值对象表示领域值。decisions.md 说明各模式的使用时机、决策流程图、架构权衡与常见场景。structure.md 覆盖完整项目组织、文件放置规则、命名空间约定以及 Web 与 API 的区分。examples.md 提供完整可运行示例、端到端工作流与真实模式。checklist.md 给出实施清单,包括初始化任务、功能开发流程与生产部署步骤。
核心原则:领域逻辑放在可调用的 Action 类中;不传递原始类型,始终用 DTO 传输数据;HTTP 层保持轻薄,控制器只处理 HTTP 关注点;使用自定义查询构建器替代 scope 以获得类型安全查询;每个文件使用 declare(strict_types=1) 严格类型。
快速决策:处理领域逻辑用 Action;传输数据用 DTO;校验用户输入用 Form Request;简单状态字段用 Enum;复杂状态转换用状态机;外部 API 用配合 Saloon 的 Service;后台处理用 Job 并委托给 Action。详细指引见 decisions.md 中的决策流程图。
限制:资料未提供具体安装命令、版本要求、收费信息或平台支持范围,暂未提供。