# Webman-Badmin

**Repository Path**: cachette/webman-badmin

## Basic Information

- **Project Name**: Webman-Badmin
- **Description**: 从Buildadmin 迁移 。后端基于 Webman 高性能框架 的后台管理系统，继承 BuildAdmin 功能特性.
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-04-14
- **Last Updated**: 2025-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Webman 后台管理系统（迁移自 BuildAdmin）

![Webman Logo](https://webman.docmirror.cn/static/logo.png)  
基于 **Webman 高性能框架** 重构的后台管理系统，继承 BuildAdmin 功能特性.


---

## 🚀 项目概述

原项目基于 ThinkPHP 框架构建，现完整迁移至 **[Webman](https://www.workerman.net/webman)** 框架，带来以下核心优势：  
✅ **高性能** - 基于 Workerman 常驻内存，吞吐量提升 10x+  
✅ **长连接支持** - 内置 WebSocket/HTTP 长连接服务，支持实时消息推送  
✅ **低资源消耗** - 单进程处理千级并发，内存占用低于 50MB  
✅ **平滑迁移** - 保留 BuildAdmin 原有 UI 及业务逻辑，无缝兼容 Vue3 前端

---

## 📦 功能特性

### 核心模块
- **代码生成器** - 一键生成 CURD 代码及 API 文档

### Webman 增强能力


---

## ⚙️ 环境要求

| 组件          | 最低版本 | 推荐版本 |
|-------------|------|------|
| PHP         | 8.0  | 8.2  |
| Redis       | 5.0  | 7.0  |
| MySQL       | 5.7  | 8.0  |
| Node.js     | 18.x | 22.x |

**必选扩展**: `pcntl`, `posix`, `redis`, `pdo_mysql`, `openssl`

---

## 🛠️ 快速安装

### 1. 克隆仓库
```bash
git clone https://gitee.com/rocareer/webman-badmin.git
cd webman-badmin
```

### 2. 安装依赖
```bash
# 后端依赖
composer install --optimize-autoloader --no-dev
composer webman-console
composer webman/think-orm

# 前端依赖
cd web/resources
pnpm install --shamefully-hoist
```

### 3. 配置环境
复制并修改环境文件：
```bash
cp .env.example .env
# 编辑数据库、Redis、应用密钥等配置
vim .env
```

### 4. 初始化系统
```bash
# 生成前端静态资源
pnpm build

# 执行数据库迁移及初始化
php webman migrate:refresh --seed

# 启动服务（开发模式）
php start.php start
```

---

## 🔧 生产环境部署

### 进程守护



### Nginx 代理配置
```nginx

```

---

## 📄 配置说明

### 关键配置文件

### 多环境切换


---

## ❓ 常见问题

### Q1: 
```bash

```

### Q2: WebSocket 连接失败？
- 检查防火墙开放对应端口
- 确认 Nginx 代理配置包含 `Upgrade` 头
- 查看 `runtime/logs/workerman.log` 日志

### Q3: 如何添加新进程？
1. 在 `process` 目录创建进程类
2. 修改 `config/process.php` 注册进程
```php
return [
    #进程名称
    'name' => [
        #进程类  
        'handler' => process\Monitor::class,
        #进程数量
        'count'   => 1, 
    ],
];
```

### Q4: 前端类似错误？

```bash
  ✘ [ERROR] Failed to resolve entry for package "v-code-diff". The package may have incorrect main/module/exports specified in its package.json. [plugin vite:dep-scan]

    node_modules/.pnpm/esbuild@0.25.2/node_modules/esbuild/lib/main.js:1227:21:

```
- 1. 删除 `web/node_modules` 目录
- 2. 在 `web/package.json` 中添加 
```json
{
  "other": "other",
  "pnpm": {
    "onlyBuiltDependencies": [
      "@parcel/watcher",
      "esbuild",
      "v-code-diff",
      "vue-demi"
    ]
  }
}
```
- 3. 重新安装依赖 `pnpm install`
- 4. 重新构建 `pnpm build` 后运行 `pnpm dev` 本地调试
---

## 📜 开源协议

[MIT License](LICENSE) © 2024-2026 Albert@Rocareer.com

**致谢**
- [BuildAdmin](https://www.buildadmin.com) - 原项目基础
- [Webman](https://www.workerman.net/webman) - 高性能框架支持
- [Element Plus](https://element-plus.org) - 前端 UI 库

[![Fork on Gitee](https://img.shields.io/badge/dynamic/json?
label=Fork&query=forks_count&url=https://gitee.
com/api/v5/repos/rocareer/webman-badmin&color=blue&logo=gitee)](https://gitee.
com/rocareer/webman-badmin/fork)