概覽
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 化開發環境 - 本機開發 stack 準備了 PostgreSQL、Redis 等容器化服務，減少不同機器之間的環境漂移。
- 文件工作流 - 透過 Scribe 生成公開 API 文件，讓開發者說明與實際 endpoint 保持接近。
- AI-ready 維護上下文 - 專案規則與 Laravel Boost MCP 支援讓後續編碼工作更容易遵循 starter 的約定。
關鍵特性
- 面向生產的預設能力 - 認證、RBAC、限流、檔案上傳、稽核、驗證與文件從一開始就被納入。
- 自託管 BaaS 替代方案 - 面向希望掌握後端基礎設施、但仍想複用通用 backend primitives 的團隊。
- 開發者文件 - 公開文件覆蓋安裝、配置、認證、檔案與 API 行為，降低採用成本。
- 可複用 API 基座 - 適合用於啟動新的 Laravel API 產品、內部管理後端、SaaS 服務與 integration-first 系統。