用途:为使用 Laravel 12.x 开发应用提供推荐的软件工程实践,适用于新建或已有项目,也适用于选择标准 MVC 还是领域驱动结构、建立质量门禁、设计模型与数据访问、制定测试策略以及强化安全等场景。
主要能力:项目设置方面,建议新项目优先使用官方 starter kits,前端可选 React、Vue 或 Livewire 版本,已集成 Inertia 2.0、TypeScript、Shadcn/UI 与 Tailwind CSS;如需社交登录、passkeys 与 SSO,可考虑 WorkOS AuthKit 变体。架构上,中小型应用沿用默认 app/ 结构,复杂应用可按领域组织代码;所有 PHP 文件启用 declare(strict_types=1);。代码质量使用 Laravel Pint 执行 PER 编码风格,PHPStan 建议至少 Level 5,Rector 用于升级到 PHP 8.2+ 语法。Eloquent 方面,HasUuids 默认支持 UUIDv7;可用 toResource() 与 toResourceCollection() 转换资源;始终使用 $fillable 或 $guarded;开发环境可启用 Model::preventLazyLoading 防止 N+1。测试推荐 Pest PHP,PHPUnit 用户需使用 v12;使用模型工厂生成数据,API 测试用 fluent JSON 断言,队列用 Queue::fake() 验证。安全上,验证逻辑放入 FormRequest,授权严格使用 Policies 与 Gates,依赖 Blade 自动转义与 Eloquent 参数绑定。性能上可用 Cache::remember、HTTP 客户端 afterResponse() 钩子以及队列与 Horizon。
使用方式与限制:资料未提供具体安装命令或调用步骤,仅给出上述实践与少量代码片段。Laravel 12 为维护版本,框架本身无破坏性变更,但上游依赖如 Carbon 3 可能有细微差异,需留意。