核心用法
本技能提供 Laravel 生态系统的完整开发规范，以现代 PHP 8.4 特性为基础构建企业级应用。核心架构遵循"瘦控制器、厚服务、富模型"原则：控制器仅负责验证输入、调用服务、返回响应；业务逻辑封装于依赖注入的服务类；跨边界操作使用单职责的 Action 类。代码风格强制 declare(strict_types=1)，采用早返回模式避免 else，注释仅解释"为什么"而非"做什么"。
Eloquent 与数据层
强调查询优化与内存管理：禁用懒加载以捕获 N+1 问题、仅选择必要字段、批量操作优先于内存加载、使用 upsert/Prunable 处理大规模数据。安全层面强制使用 $fillable 替代 $guarded = []，防止批量赋值漏洞。
API 设计
契约优先（Contract-first）方法论：先定义 API Resource 和 Form Request，再实现控制器。所有响应遵循统一信封格式 {success, data, error, meta}，并通过 toDto() 模式确保边界验证后的类型安全传递。
生产韧性
- 启动时配置验证：关键缺失配置应在服务提供者
boot()中触发崩溃，而非延迟到运行时 - 健康检查端点：
/health（浅层存活）与/ready（深层依赖检查）双端点模式 - 故障模式：队列任务必须实现
failed()回调，批量任务配置then/catch/finally链式处理
测试策略
默认采用 Feature 测试覆盖完整 HTTP 栈，隔离逻辑使用 Unit 测试。强制工厂模式生成数据，禁止原始 DB::table 插入。断言需同时验证响应状态与副作用（数据库状态、队列投递、通知发送）。目标覆盖率 80%+。
显著优点
1. PHP 8.4 特性全覆盖：readonly 类、构造函数提升、match 表达式、属性钩子、非对称可见性等现代语法优先推荐
2. 防坑指南具体化：明确列出四个生产级陷阱（Observer 作用域污染、query-builder 绕过事件、jsonb 并发覆盖、date cast 序列化差异），每个附检测方法与修复方案
3. 分层架构清晰：Feature 文件夹组织、Action/Service/Form Request 职责分离、Events 隔离副作用
4. 性能与可靠性并重：chunk/lazy collection 内存优化、索引策略、preventLazyLoading 开发期防护
潜在局限
- 框架锁定：深度绑定 Laravel 生态，迁移至其他 PHP 框架（如 Symfony、Slim）需重构
- PHP 版本门槛：PHP 8.4 特性无法向下兼容，旧项目升级成本高
- Swoole/ReactPHP 异步：仅提及 Fibers 作为降级方案，对常驻进程/协程模式覆盖有限
- 安全认证缺失：报告标注"未执行安全扫描"，安全等级（S+）为占位符
适合人群
- Laravel 中高级开发者：已掌握基础，需规范大型项目架构
- 技术负责人/架构师：制定团队编码标准与 CI 流程
- 从其他语言迁移者：熟悉 Java/C# 依赖注入、领域驱动设计模式，快速映射到 Laravel 实现
常规风险
- Observer 误用风险：全局清理操作可能误删兄弟节点数据，需严格审计
deleting钩子作用域 - 批量更新事件丢失：
Model::query()->update()绕过 Eloquent 事件，审计与级联逻辑失效 - 并发数据覆盖：jsonb 列的 decode-mutate-encode 模式在
chunkById中丢失并发写入 - API 契约破坏：Hyrum's Law 警告——任何可观察字段变更均为破坏性变更，需遵循"添加优于修改"原则