# 码支付 V2

**Repository Path**: technical-laohu/mpay_v2_webman

## Basic Information

- **Project Name**: 码支付 V2
- **Description**: 码支付[mpay]是一款便捷的在线收款工具，使用webman框架开发，支持个人免签收款，三方支付聚合码收款，能通过API对接主流收款服务商平台（如微信支付、支付宝、银联官方等）
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 2
- **Created**: 2025-06-27
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# MPay V2 Webman

基于 Webman 框架开发的支付系统后台管理 API。

## 项目简介

MPay V2 Webman 是一个采用 Webman 高性能 PHP 框架构建的支付系统后台管理接口，提供用户认证、权限管理、系统配置、菜单路由等核心功能。

## 技术栈

- **后端框架**: Webman
- **PHP 版本**: PHP 8.0+
- **数据库**: MySQL
- **缓存**: Redis
- **认证**: JWT

## 图片展示
<img src="doc/img/1.png" width=640 />
<img src="doc/img/2.png" width=640 />

## 项目结构

```
app/
├── command/          # 命令行控制器
├── common/           # 公共基础类
│   ├── base/         # 基础类（Controller、Model、Service、Repository）
│   ├── constants/    # 常量定义
│   ├── enums/        # 枚举类
│   ├── middleware/   # 中间件
│   └── utils/        # 工具类
├── events/           # 事件类
├── exceptions/       # 异常类
├── http/             # HTTP 控制器
│   └── admin/        # 后台管理接口
│       ├── controller/  # 控制器
│       └── middleware/  # 中间件
├── models/           # 数据模型
├── process/          # 进程管理
├── repositories/     # 数据仓库
├── services/         # 业务服务
└── validation/       # 验证器
config/               # 配置文件
database/             # 数据库脚本
doc/                  # 文档
public/               # 公共资源
support/              # 框架支持类
```

## 核心功能

### 认证模块
- 用户登录/登出
- 验证码生成与验证
- JWT Token 认证
- 用户信息获取

### 权限管理
- 菜单路由管理
- 用户角色关联

### 系统配置
- 系统参数配置
- 字典管理
- 表单配置
- 配置缓存管理

### 中间件
- CORS 跨域处理
- 静态文件处理
- 认证鉴权

## 快速开始

### 环境要求

- PHP >= 8.0
- Composer
- Redis
- MySQL >= 5.7

### 安装步骤

1. 克隆项目
```bash
git clone https://gitee.com/technical-laohu/mpay_v2_webman.git
cd mpay_v2_webman
```

2. 安装依赖
```bash
composer install
```

3. 配置数据库
编辑 `config/database.php` 配置数据库连接信息。

4. 配置 Redis
编辑 `config/redis.php` 配置 Redis 连接信息。

5. 导入数据库
```bash
mysql -u用户名 -p 数据库名 < database/ma_system_config.sql
```

6. 启动服务
```bash
# Linux/Mac
php start.php start

# Windows
windows.bat
```

## API 接口

### 认证接口

| 接口 | 方法 | 描述 |
|------|------|------|
| `/admin/auth/captcha` | GET | 获取验证码 |
| `/admin/auth/login` | POST | 用户登录 |

### 用户接口

| 接口 | 方法 | 描述 |
|------|------|------|
| `/admin/user/info` | GET | 获取当前用户信息 |

### 菜单接口

| 接口 | 方法 | 描述 |
|------|------|------|
| `/admin/menu/routers` | GET | 获取菜单路由 |

### 系统接口

| 接口 | 方法 | 描述 |
|------|------|------|
| `/admin/system/dict/{code}` | GET | 获取字典数据 |
| `/admin/system/tabs` | GET | 获取标签页配置 |
| `/admin/system/config/{tabKey}` | GET/POST | 获取/提交表单配置 |

## 异常处理

项目定义了以下自定义异常类：

- `BadRequestException` - 请求参数错误 (400)
- `UnauthorizedException` - 未授权 (401)
- `ForbiddenException` - 禁止访问 (403)
- `NotFoundException` - 资源不存在 (404)
- `ValidationException` - 参数校验失败 (422)
- `InternalServerException` - 系统内部错误 (500)

## 配置说明

主要配置文件位于 `config/` 目录：

- `app.php` - 应用配置
- `database.php` - 数据库配置
- `redis.php` - Redis 配置
- `jwt.php` - JWT 配置
- `route.php` - 路由配置
- `middleware.php` - 中间件配置
- `cache.php` - 缓存配置
- `log.php` - 日志配置

## 许可证

本项目基于 MIT 许可证开源。