# 崇胜SaaS框架

**Repository Path**: chshcms/saas

## Basic Information

- **Project Name**: 崇胜SaaS框架
- **Description**: 崇胜SaaS框架是一个基于 PHP 开发的 SaaS 框架，主要用于构建各种类型的应用。框架采用模块化设计，支持多站点管理，提供完整的数据库操作、控制器管理、模型管理等功能。
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-09-16
- **Last Updated**: 2026-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 崇胜SaaS框架

> 一套基于原生 PHP 打造的多租户 SaaS 内容管理系统框架，适用于快速搭建小程序 SaaS 平台、应用分发平台、内容付费平台等业务系统。

- 版本：v2.0.8
- 作者：桂林崇胜网络科技有限公司（烟雨江南）
- 官网：http://www.chshsaas.com/

## 功能特性

- **自研框架**：轻量级自研 MVC 框架，无需 Composer，开箱即用
- **多租户 SaaS**：内置多站点、多租户数据隔离机制，支持子应用开通与授权
- **后台管理**：完整的后台权限控制、系统配置、应用管理、数据统计
- **多端适配**：同时支持 PC 端、移动端（H5）、微信内置浏览器访问检测
- **微信生态**：集成公众号（Wxmp）、小程序（WxApplet）、微信支付（Wxpay/Wxpayv3）
- **支付体系**：支持支付宝（Alipay）、微信支付 V2/V3、Apple Pay
- **AI 能力**：聚合 11 家主流 AI 大模型服务，统一调用接口
- **WebSocket**：内置 WebSocket 客户端，支持实时通信场景
- **上传体系**：支持本地、FTP、阿里云 OSS 等多种存储驱动
- **安全机制**：加密密钥、授权校验、CSRF 防护、跨域头控制

## 环境要求

| 项 | 要求 |
|---|---|
| PHP | 7.3 及以上（推荐 7.4 / 8.x） |
| MySQL | 5.6 及以上 |
| Web 服务器 | Apache / Nginx + PHP-FPM |

### PHP 扩展要求

`mysqli`、`curl`、`gd`、`mbstring`、`openssl`、`pdo_mysql`、`zip`、`sockets`、`fileinfo`、`exif`

## 目录结构

```
www__cscms__saas/
├── index.php              # 前台入口
├── admin.php              # 应用后台管理入口
├── saas.php               # SaaS框架后台入口
├── config.php             # 全局配置文件
├── .htaccess              # Apache 重写规则
├── attachment/            # 附件存储目录
├── caches/                # 缓存目录
├── packs/                 # 静态资源包
├── plugins/               # 应用目录
└── cscms/                 # 框架核心目录
    ├── Cscms.php          # 核心初始化与路由类
    ├── config/            # 框架配置（版本、合作方信息）
    ├── controller/        # 控制器目录
    │   ├── Index.php      # 前台首页
    │   ├── Install.php    # 安装向导
    │   ├── Apply.php      # 应用开通
    │   ├── Wxlog.php      # 微信日志
    │   └── admin/         # 后台控制器
    │       ├── Index.php  # 后台首页
    │       ├── Login.php  # 后台登录
    │       ├── Setting.php# 系统设置
    │       └── Update.php # 在线更新
    ├── model/             # 数据模型
    │   ├── Db.php         # 数据库操作类（mysqli）
    │   ├── BaseModel.php  # 模型基类
    │   └── Admin.php      # 管理员模型
    ├── class/             # 工具类库
    │   ├── Ai.php         # AI 聚合调度
    │   ├── Alipay.php     # 支付宝
    │   ├── Applepay.php   # Apple Pay
    │   ├── Wxmp.php       # 公众号
    │   ├── WxApplet.php   # 小程序
    │   ├── Wxpay.php      # 微信支付 V2
    │   ├── Wxpayv3.php    # 微信支付 V3
    │   ├── Upload.php     # 上传处理
    │   ├── Files.php      # 文件操作
    │   ├── Qrcode.php     # 二维码
    │   ├── Cszip.php      # 压缩解压
    │   ├── WebSocket.php  # WebSocket 客户端
    │   └── ai/            # AI 大模型适配器
    │       ├── openai/    # OpenAI
    │       ├── deepseek/  # DeepSeek
    │       ├── kimi/      # Kimi 月之暗面
    │       ├── zhipu/     # 智谱 GLM
    │       ├── tongyi/    # 通义千问
    │       ├── doubao/    # 字节豆包
    │       ├── hunyuan/   # 腾讯混元
    │       ├── baidu/     # 百度文心
    │       ├── google/    # Google Gemini
    │       ├── minimax/   # MiniMax
    │       └── keling/    # 可灵 AI
    ├── sdk/               # 第三方 SDK
    │   ├── alipay/        # 支付宝 SDK
    │   ├── aliyun/        # 阿里云 OSS SDK
    │   ├── ftp/           # FTP SDK
    │   └── api/           # 接口工具
    ├── function/          # 公共函数库
    ├── language/          # 多语言包
    ├── tpl/               # 视图模板
    └── error/             # 错误页面
```

## 入口说明

| 入口文件 | 访问路径 | 作用 |
|---|---|---|
| `index.php` | `/` | 前台入口，展示前台页面与 SaaS 应用 |
| `admin.php` | `/admin.php` | 应用后台管理入口，定义 `IS_ADMIN` 常量 |
| `saas.php` | `/saas.php` | SaaS框架后台入口，定义 `IS_SYSTEM` 标识 |

## 快速安装

### 1. 部署代码

将项目代码部署到 Web 服务器根目录。

### 2. 配置数据库

编辑根目录的 `config.php`，修改数据库连接信息：

```php
'db' => array (
    'hostname' => '127.0.0.1',
    'database' => 'saas',
    'username' => 'root',
    'password' => 'root',
    'charset' => 'utf8',
),
```

### 3. 访问安装向导

浏览器访问项目根路径，未安装时会自动跳转到安装向导：

```
http://你的域名/index.php/install
```

按步骤完成数据库初始化与管理员账号设置即可。

### 4. 访问框架后台

安装完成后，访问：

```
http://你的域名/saas.php
```

使用安装时设置的管理员账号登录。

## 核心配置说明

`config.php` 关键配置项：

| 配置项 | 说明 |
|---|---|
| `name` | 站点名称 |
| `url` | 站点域名（含端口） |
| `appsecret` | 应用通信密钥 |
| `crypt_key` | 数据加密密钥（安装后自动生成） |
| `api_key` | 对外 API 调用密钥 |
| `safety.name` | 后台安全验证用户名 |
| `safety.pass` | 后台安全验证密码（MD5） |
| `safety.code` | 后台安全验证码 |
| `db` | 数据库连接配置 |
| `mp` | 微信公众号配置（appid、appsecret） |

## AI 模型接入

框架内置 AI 聚合调度器，统一封装多家大模型接口：

- 国内：DeepSeek、Kimi、智谱 GLM、通义千问、豆包、混元、文心、MiniMax、可灵
- 海外：OpenAI、Google Gemini

通过 `cscms/class/Ai.php` 统一调用，支持对话、流式响应、图片生成、音频生成、视频生成等场景。

## 支付接入

| 通道 | 类文件 | 说明 |
|---|---|---|
| 支付宝 | `class/Alipay.php` + `sdk/alipay/` | 手机网站支付、当面付 |
| 微信支付 V2 | `class/Wxpay.php` | JSAPI、Native、H5 |
| 微信支付 V3 | `class/Wxpayv3.php` | V3 协议、证书签名 |
| Apple Pay | `class/Applepay.php` | 苹果内购校验 |

## 开发文档

- 文档地址：https://www.chshsaas.com/docs

## 许可声明

本项目基于 [Apache License 2.0](LICENSE) 协议开源。

- ✅ 允许商业使用：可使用本框架开发应用并进行销售
- ✅ 允许修改：可自由修改源码
- ✅ 允许闭源：基于本框架开发的应用无需开源
- 📌 须保留版权声明与 LICENSE 文件
- 📌 修改代码须注明更改
- 📌 不得使用原作者商标进行推广

详细条款请参阅 [LICENSE](LICENSE) 文件。

- 官方网站：http://www.chshsaas.com/
- Gitee 仓库：https://gitee.com/chongshengkeji/saas.git

## 技术支持

- 官方网站：http://www.chshsaas.com/
- 技术咨询请通过官方网站联系