PHP & Laravel 开发技能评估
核心定位
本技能定位为现代 Laravel 工程实践知识库，非基础教程，而是面向中高级开发者、技术负责人和架构师的深度参考文档。内容聚焦于 Laravel 11.x 及 PHP 8.4 生态，强调类型安全、可维护性、生产韧性三大原则。
显著优点
1. 语言版本前瞻性强
全面覆盖 PHP 8.4 特性（Property Hooks、非对称可见性、DNF 类型、新的 array_find/all/any 函数），帮助团队提前适配现代 PHP 范式，减少技术债务。
2. 架构模式清晰务实
- 明确区分 Controller/Service/Action/Form Request 职责边界
- 倡导"契约优先"（Contract-first）的 API 设计，强调 Hyrum 定律意识
- 提出 Feature-folder 组织方式替代传统按类型分层，适配中大型项目
3. 生产级细节丰富
- 健康检查端点设计（
/healthvs/ready） - 配置校验的 Fail-fast 原则
- 迁移事务边界控制（
$withinTransaction的坑与对策） - 数据库层批量操作 vs Eloquent 事件权衡
4. 测试体系完整
区分 Feature/Unit 测试边界，提供 Facade Faking、HTTP Mock、授权断言等 Laravel 专属模式，并关联独立的 ia-writing-tests 技能形成体系。
5. 踩坑案例极具价值
文档收录 10+ 真实生产故障模式，包括：
- Query-builder
update()静默跳过 Observer chunkById并发写入丢失- Carbon 年份解析歧义（
'2020'解析为时间而非年份） - 嵌套数组验证的标量穿透漏洞
- Pivot 操作无事件审计等
每个案例均含检测方法与修复方案，可直接纳入代码审查 Checklist。
潜在局限
1. 版本锁定较新
PHP 8.4 特性要求团队保持较新的运行时版本，对遗留项目或 LTS 保守策略的团队适用性受限。
2. assumes Laravel 生态深度绑定
技能明确排除 "php-src 内部实现、独立 PHP 库、通用 PHP 语言讨论"，纯 PHP 开发者或框架无关的库作者需另寻资源。
3. PostgreSQL 特性依赖外部技能
迁移章节提到的 expand-contract 模式需交叉引用 ia-postgresql 技能，未内建完整说明。
4. 缺乏可视化/工具链集成
未涉及 CI/CD 模板、IDE 配置、Laravel Pint 等代码格式化工具的集成建议。
适合人群
| 角色 | 收益重点 |
|------|---------|
| Laravel 后端工程师 | 日常开发规范、Eloquent 高级用法、测试策略 |
| 技术负责人/架构师 | 目录组织、服务边界、API 契约设计、生产韧性 |
| 代码审查者 | "Common Pitfalls" 章节可直接转化为 Review 规则 |
| 从旧版本迁移团队 | PHP 8.x 特性适配清单、现代化重构路径 |
常规风险
认知风险：部分内容（如 DB::afterCommit 的局限性、Carbon::parse 的歧义解析）属于反直觉行为，开发者易误用。建议团队将 Common Pitfalls 章节固化为静态规则或 Lint 工具。
安全风险：$guarded = [] 的警告、mass assignment 相关说明虽正确，但依赖开发者自觉执行。建议配合 laravel-security 等专项扫描工具。
版本漂移风险：PHP 8.4 部分特性（Property Hooks）尚在稳定化过程中，生产环境需验证具体 patch 版本的实现一致性。
来源可信度
本技能为社区最佳实践聚合型文档，非官方 Laravel 文档替代品。内容质量高（作者可见丰富实战经验），但：
- 未标注具体案例来源（内部项目/开源仓库/官方 RFC）
- 部分建议（如 PHPStan Level 9 目标）为 opinionated 工程决策
- 交叉引用技能（
ia-postgresql,ia-writing-tests）未提供获取方式
建议作为团队内部 Laravel 规范的基底文档，关键决策仍需交叉验证官方文档与 RFC。