概览
Laravel API Boilerplate 是一个基于 Laravel 12 的开源 API starter，用于构建可投入生产的 RESTful 后端。它把多数后端产品都会重复搭建的基础能力整理在一起，包括认证、基于角色的权限控制、文件上传、审计记录、限流、Docker、本地开发环境、自动生成的 API 文档，以及统一的响应结构。
这是一个由我个人企划、设计、编码、编写文档、部署与维护的开发者工具。它的目标是把重复的后端初始化工作沉淀为一个可配置的基础模板，用于 SaaS 产品、内部工具与 API-first 服务。
产品架构
- Laravel 12 API 基础层 - 项目围绕 API 产品开发组织 routes、controllers、middleware、policies、resources、data objects 与 tests，而不是停留在演示型结构。
- 配置优先的功能开关 - 核心能力尽量通过配置启用或关闭，让 starter 可以被不同项目复用，而不需要大量删除代码。
- 认证层 - Laravel Sanctum 提供 token-based API 访问能力，同时支持 passwordless OTP 与 social login 方向，方便不同产品选择合适的登录方式。
- 权限模型 - Laratrust 负责角色与权限控制，让应用可以在一开始就拥有 RBAC 基础，而不是业务功能完成后再补访问控制。
- 统一 API 契约 - 成功响应、错误响应、分页与验证错误使用一致的 envelope，降低 web、mobile 与第三方消费者的接入成本。
- 文件与审计服务 - 文件上传、临时文件生命周期与 append-only audit log 被作为后端基础能力纳入 starter。
- Docker 化开发环境 - 本地开发栈准备了 PostgreSQL、Redis 等容器化服务，减少不同机器之间的环境漂移。
- 文档工作流 - 通过 Scribe 生成公开 API 文档，让开发者说明与实际 endpoint 保持接近。
- AI-ready 维护上下文 - 项目规则与 Laravel Boost MCP 支持让后续编码工作更容易遵循 starter 的约定。
关键特性
- 面向生产的默认能力 - 认证、RBAC、限流、文件上传、审计、验证与文档从一开始就被纳入。
- 自托管 BaaS 替代方案 - 面向希望掌握后端基础设施、但仍想复用通用 backend primitives 的团队。
- 开发者文档 - 公开文档覆盖安装、配置、认证、文件与 API 行为，降低采用成本。
- 可复用 API 基座 - 适合用于启动新的 Laravel API 产品、内部管理后端、SaaS 服务与 integration-first 系统。