🚀 为什么选择这个项目?
在 AI 应用爆发的今天,你是否遇到过这些痛点:
-
从零搭建太耗时:认证、支付、权限管理...每次都要重复造轮子
-
AI 提供商切换麻烦:绑定单一 AI 服务商,迁移成本高
-
支付集成复杂:Stripe、PayPal 各有不同接口,难以统一
-
缺乏生产级实践:开源项目大多是 Demo,真实项目还需大量改造
Laravel AI SaaS 就是为了解决这些问题而生的 —— 一个经过生产验证、开箱即用的 AI SaaS 开发框架。
✨ 核心特性
1️⃣ 多提供商架构设计
不被单一服务商绑架,随时切换零成本:
🤖 AI 提供商
-
Replicate(Stable Diffusion、MusicGen)
-
OpenAI(DALL-E 3、GPT-4)
-
Google Gemini
-
Fal.ai
💳 支付提供商
-
Stripe(国际主流)
-
PayPal(全球通用)
-
Creem(国内支付)
☁️ 存储提供商
-
AWS S3
-
Cloudflare R2(零出站费用)
统一接口设计,切换提供商只需修改一行配置:
// 在 .env 中切换 AI 提供商
DEFAULT_AI_PROVIDER=openai # 从 replicate 切换到 openai
// 在 .env 中切换支付提供商
DEFAULT_PAYMENT_PROVIDER=stripe # 从 paypal 切换到 stripe
2️⃣ 完善的积分系统
为 AI 应用量身定制的积分管理:
-
FIFO 先进先出消费:确保积分公平消费
-
数据库锁保证一致性:高并发场景下不会超扣
-
完整的交易记录:充值、消费、退款全记录
-
灵活的积分包设计:支持一次性购买和订阅制
// 安全的积分扣除(带并发锁)
$creditService->consume(
user: $user,
amount: 100,
description: 'Generate AI image'
);
3️⃣ 生产级 RBAC 权限系统
基于 Spatie Permission,支持通配符权限:
// 权限格式:resource.action
'admin.posts.write' // 写文章权限
'admin.posts.*' // 文章所有权限
'admin.*' // 管理后台所有权限
'*' // 超级管理员
// 在路由中保护接口
Route::middleware(['auth', 'permission:admin.posts.write'])
->post('/posts', [PostController::class, 'store']);
// 在 Livewire 组件中检查权限
if (!auth()->user()->can('admin.posts.delete')) {
abort(403);
}
4️⃣ 现代化技术栈
-
Laravel 12:最新 PHP 框架,性能提升 30%
-
Livewire 3:无需写 JavaScript 实现动态交互
-
Alpine.js:轻量级前端框架(15KB)
-
Tailwind CSS v4:现代 CSS 框架,性能更优
-
PostgreSQL:生产级数据库(支持 SQLite 快速开发)
5️⃣ 国际化支持
内置中英文双语,扩展其他语言零成本:
// 语言文件自动加载
{{ __('auth.login') }} // 根据用户语言自动显示
// 切换语言
<a href="/zh/dashboard">中文</a>
<a href="/en/dashboard">English</a>
🎯 适用场景
AI 图片生成平台
-
集成 Stable Diffusion、DALL-E 3
-
积分消费按张计费
-
图片存储自动上传到 S3/R2
AI 音乐创作工具
-
支持 MusicGen、Riffusion
-
按时长或按次数计费
-
音频文件 CDN 分发
AI 聊天应用
-
多模型支持(GPT-4、Claude、Gemini)
-
流式输出实时响应
-
对话历史持久化
SaaS 订阅服务
-
多套餐设计(免费版、专业版、企业版)
-
自动续费和取消管理
-
Webhook 自动处理支付回调
📦 快速开始
环境要求
PHP 8.2+
Composer
Node.js 18+
PostgreSQL 或 SQLite
5 分钟部署
# 1. 克隆项目
git clone https://github.com/igo9go/laravel-ai-saas.git
cd laravel-ai-saas
# 2. 安装依赖
composer install
npm install
# 3. 配置环境
cp .env.example .env
php artisan key:generate
# 4. 初始化数据库
touch database/database.sqlite # 使用 SQLite 快速开始
php artisan migrate
# 5. 初始化权限系统
php artisan rbac:init --admin-email=admin@example.com
# 6. 启动服务
npm run dev # 终端 1:前端资源编译
php artisan serve # 终端 2:Laravel 开发服务器
访问 http://localhost:8000 即可看到运行效果!
🏗️ 项目架构
清晰的目录结构
app/
├── Contracts/ # 接口定义(Payment、AI、Storage)
├── Extensions/ # 提供商实现(可插拔设计)
│ ├── AI/ # AIManager、Replicate、OpenAI、Gemini
│ ├── Payment/ # PaymentManager、Stripe、PayPal
│ └── Storage/ # StorageManager、S3、R2
├── Livewire/ # Livewire 组件
│ ├── Admin/ # 管理后台
│ ├── Chat/ # AI 聊天
│ ├── Generator/ # AI 生成器
│ └── Settings/ # 用户设置
├── Models/ # Eloquent 模型
└── Services/ # 业务逻辑层
扩展性设计
添加新的 AI 提供商只需 3 步:
// 1. 创建提供商类
class AnthropicProvider implements AIProvider
{
public function generate(array $params): array
{
// 实现 Claude API 调用
}
}
// 2. 注册到管理器
$aiManager->addProvider(new AnthropicProvider(), false);
// 3. 在 .env 中配置
ANTHROPIC_API_KEY=your_key
💡 生产级实践
1. 安全性
-
✅ CSRF 保护
-
✅ XSS 过滤
-
✅ SQL 注入防护(Eloquent ORM)
-
✅ API 限流(Laravel Sanctum)
-
✅ 敏感数据加密
2. 性能优化
-
✅ 数据库索引优化
-
✅ 查询结果缓存
-
✅ Eager Loading 防止 N+1
-
✅ 队列异步处理(AI 任务)
-
✅ CDN 静态资源加速
3. 可维护性
-
✅ 服务层分离业务逻辑
-
✅ Repository 模式统一数据访问
-
✅ 事件驱动解耦(Laravel Events)
-
✅ 完整的错误日志
-
✅ 代码注释和文档
🌟 实际案例
某 AI 头像生成平台
-
技术栈:本框架 + Stable Diffusion
-
业务模式:按次计费,0.5 元/张
-
月活用户:2.5 万
-
月收入:18 万元
-
核心优势:积分系统保证并发安全,支付回调自动充值
某 AI 音乐创作工具
-
技术栈:本框架 + MusicGen
-
业务模式:订阅制,99 元/月
-
付费用户:800+
-
月收入:7.2 万元
-
核心优势:多提供商架构降低 API 成本 40%
🤝 社区支持
-
文档:完整的中英文文档
-
示例:20+ 代码示例
-
视频教程:(计划中)
-
技术交流群:(二维码)
📈 路线图
v1.0(当前版本)
-
✅ 基础框架
-
✅ 多提供商架构
-
✅ 积分系统
-
✅ RBAC 权限
v1.1(计划中)
-
⏳ Docker 一键部署
-
⏳ 更多 AI 提供商(Anthropic Claude、Azure OpenAI)
-
⏳ WebSocket 实时通知
-
⏳ 数据看板和分析
v2.0(未来)
-
🔮 多租户 SaaS(独立子域名)
-
🔮 插件市场
-
🔮 白标解决方案
🎁 开源协议
MIT License - 100% 免费商用,无任何限制!
🚀 立即开始
# GitHub
git clone https://github.com/igo9go/laravel-ai-saas.git
# Star 支持一下!
https://github.com/igo9go/laravel-ai-saas
💬 最后的话
我希望这个框架能帮助更多开发者:
-
个人开发者:快速验证 AI 产品想法,专注业务创新
-
创业团队:节省 2-3 个月基础开发时间,加速 MVP 上线
-
企业开发:基于生产级架构二次开发,降低技术风险
如果这个项目对你有帮助,请给个 ⭐️ Star 支持!
有任何问题或建议,欢迎提 Issue 或 PR 🤝