Laravel Expert 是一份供 AI 在执行过程中阅读的 Laravel/PHP 参考，重点不是完整文档，而是常见陷阱与决策标准。完整 Laravel 文档建议使用 Context7 查询。
用途与决策标准：在验证方式上，可复用验证用 Form Request，一次性简单检查用内联；业务逻辑上，无状态业务用 Service，单一离散操作用只含 __invoke 的 Action；解耦场景（通知、日志）用事件/监听器，紧耦合操作用直接调用；查询上，带关系的领域模型用 Eloquent，报表或批量操作使用 Query Builder。
主要易错点：N+1 问题应始终用 with() 预加载，并在 AppServiceProvider 中调用 preventLazyLoading() 便于开发期发现；PHP 8.2+ 可使用 readonly DTO，例如 readonly class UserData { public function __construct(public string $name) {} }；updateOrCreate 并非原子操作，存在竞态条件，关键操作应放入数据库事务；$model->save() 返回布尔值而非模型，不能链式调用，Model::create() 返回模型；批量赋值需用 $fillable 白名单，切勿在接收用户输入时使用 $guarded = []；firstOrFail() 抛出 ModelNotFoundException（404），first() 静默返回 null；队列任务必须实现 ShouldQueue，否则即便 dispatch() 也会同步执行；测试中的 Carbon::now() 用 $this->travel() 或 Carbon::setTestNow() 保证确定性；迁移方面绝不要修改已部署的迁移文件，应新建迁移来变更。
适用场景为 Laravel 项目开发、代码审查与迁移安全管理。限制：该资料本身为 AI 阅读型参考，不包含安装命令、版本要求、收费或完整文档内容，相关细节暂未提供。