核心定位
本技能为 PHP 8.4 与 Laravel 框架的深度开发规范，面向生产级应用构建，强调类型安全、架构清晰、可观测性三大支柱。内容覆盖从代码风格到部署韧性的全生命周期，是 Laravel 生态中最具工程严谨性的参考标准之一。
---
显著优点
1. 现代化 PHP 深度实践
全面拥抱 PHP 8.4 特性：只读类、枚举方法、DNF 类型、属性钩子、非对称可见性、new 无括号链式调用等。与主流框架技能相比，本规范禁止在生成代码中添加解释性注释——默认使用者（Claude 与专业开发者）已熟悉这些语法，体现了对受众的精准定位。
2. 生产韧性优先设计
- 启动时配置校验：关键配置缺失应在
boot()阶段立即崩溃，而非延迟到首次请求 - 分层健康检查：
/health（存活探针）与/ready（就绪探针，含 DB/Redis/外部服务）分离 - 迁移事务控制：明确区分
withinTransaction对 PostgreSQL/SQLite 与 MySQL 的差异行为，避免嵌套保存点导致的锁持有问题
3. 数据一致性工程
详细阐述 expand-contract 模式、JSONB 并发写入防护、批量操作的事件绕过风险等真实生产陷阱。每个陷阱均附带具体修复方案与检测方法，远超一般"最佳实践"的泛泛而谈。
4. 测试策略分层
- Feature/Unit 测试职责边界清晰
- Facade Fake 模式（Queue::fake、Http::fake）的使用时序规范
- 外部存储（DynamoDB/S3）在
migrate:fresh下的幂等性要求
---
潜在局限
1. 版本锁定严格
PHP 8.4 特性为主，对 8.1-8.3 项目存在兼容压力。array_find() 等函数降级需 polyfill，增加维护成本。
2. PostgreSQL 中心化
迁移事务行为、JSONB 操作示例均以 PostgreSQL 为默认假设，MySQL 用户需自行调整（如 withinTransaction 无实际效果）。
3. 技能交叉依赖
测试深度内容指向 ia-writing-tests、ia-postgresql 等外部技能，独立使用时可能信息断层。
4. 学习曲线陡峭
"Happy path last"、DNF 类型、属性钩子等要求开发者具备较深的类型系统理解，不适合 Laravel 初学者直接套用。
---
适合人群
- Laravel 高级开发者：需构建 20+ 模型规模的中大型应用，寻求 Feature folder 等组织策略
- 架构师/技术负责人：关注生产韧性、配置校验、健康检查等运维衔接设计
- PHP 现代化迁移团队：从 7.x/8.0 升级至 8.4，需系统性语法与模式更新指南
- 代码审查者：需要权威参考标准识别 Eloquent 事件绕过、Observer 作用域错误等隐蔽缺陷
---
常规风险
| 类别 | 具体风险 | 缓释建议 |
|:---|:---|:---|
| **静态分析盲区** | PHPStan level 8+ 无法捕获运行时 N+1、事务隔离级别误配 | 启用 `Model::preventLazyLoading(!app()->isProduction())` 开发期拦截 |
| **事件系统误用** | `update()` 查询构建器跳过 Observer，导致审计缺失 | 强制代码审查中检查批量操作注释 `// intentionally bypasses` |
| **并发数据丢失** | `chunkById` + JSON 解码/编码覆盖并发写入 | 使用 `DB::raw("jsonb_set(...)")` 原地修改，或 `lockForUpdate()` || **验证规则漏洞** | 嵌套数组 `*.field` 规则未强制元素为数组 | 必须配对 `'items.*' => 'array'` 约束 |
| **Carbon 解析歧义** | `'2020'` 解析为今日 20:20 而非年份 | 年份输入强制使用 `createFromFormat('Y', $year)` |本技能本质是防御性编程手册，其价值不在于覆盖 Laravel 全部功能，而在于将生产环境中真实发生过的故障模式转化为可执行的代码规范。