Laravel AI SaaS:开箱即用的 AI 应用开发框架

8 阅读5分钟

🚀 为什么选择这个项目?

在 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 🤝