rocareer/webman-badmin

High performance HTTP Service Framework.

dev-master 2025-04-18 18:17 UTC

Requires

• php: >=8.1

Suggests

• ext-event: For better performance.

MIT

• albert

• High Performance
• http service
• webman
• buildadmin

README

基于 Webman 高性能框架 重构的后台管理系统，继承 BuildAdmin 功能特性.

🚀 项目概述

原项目基于 ThinkPHP 框架构建，现完整迁移至 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. 克隆仓库

git clone https://gitee.com/rocareer/webman-badmin.git
cd webman-badmin

2. 安装依赖

# 后端依赖
composer install --optimize-autoloader --no-dev
composer webman-console
composer webman/think-orm

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

3. 配置环境

复制并修改环境文件：

cp .env.example .env
# 编辑数据库、Redis、应用密钥等配置
vim .env

4. 初始化系统

# 生成前端静态资源
pnpm build

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

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

🔧 生产环境部署

进程守护

Nginx 代理配置

📄 配置说明

关键配置文件

多环境切换

❓ 常见问题

Q1:

Q2: WebSocket 连接失败？

• 检查防火墙开放对应端口
• 确认 Nginx 代理配置包含 Upgrade 头
• 查看 runtime/logs/workerman.log 日志

Q3: 如何添加新进程？

1. 在 process 目录创建进程类
2. 修改 config/process.php 注册进程

   return [
    #进程名称
    'name' => [
        #进程类  
        'handler' => process\Monitor::class,
        #进程数量
        'count'   => 1, 
    ],
   ];
   

Q4: 前端类似错误？

  ✘ [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 目录
• 1. 在 web/package.json 中添加

     {
     "other": "other",
     "pnpm": {
       "onlyBuiltDependencies": [
      "@parcel/watcher",
      "esbuild",
      "v-code-diff",
      "vue-demi"
       ]
     }
     }
     

• 1. 重新安装依赖 pnpm install
• 1. 重新构建 pnpm build 后运行 pnpm dev 本地调试

📜 开源协议

MIT License © 2024-2026 [e-mail]

致谢

• BuildAdmin - 原项目基础
• Webman - 高性能框架支持
• Element Plus - 前端 UI 库

[](https://gitee. com/rocareer/webman-badmin/fork)