×

一个基于 ThinkPHP 的 开箱即用通用管理后台开源底座

独孤求败 独孤求败 发表于2026-09-30 09:24:12 浏览37 评论0

抢沙发发表评论

今天给大伙儿推荐一个开源项目 —— 推荐一个本心通用管理后台底座。BenXinAdmin(本心)是一套开箱即用的通用管理后台开源底座,核心解决的是「每个项目都要从零搭用户、权限、系统管理 想深入了解的同学,建议收藏这篇。

项目地址:
https://github.com/BenXinAdmin-PHP/benxin-admin-server

01

PART


项目是什么

项目是什么

BenXinAdmin(本心)是一套开箱即用的通用管理后台开源底座,核心解决的是「每个项目都要从零搭用户、权限、系统管理」这个反复造轮子的问题。

一句话定位:在它之上,你只管写业务(打卡、商城、知识付费等),登录鉴权、RBAC 权限、菜单、字典、操作日志、文件管理这些公共能力已经备齐;更特别的是它自带一个「可复刻的代码生成器」,一张表就能直出后端四件套 + 前端页面,新模块几乎零手工。

它适合想快速起一个带后台 + 小程序/H5 三端的 PHP 团队,也适合不想在基础设施上反复投入、希望把精力集中在业务上的开发者。

BenXinAdmin 极光渐变登录页

BenXinAdmin 极光渐变登录页

BenXinAdmin 后台 Bento 数据仪表盘首页

BenXinAdmin 后台 Bento 数据仪表盘首页

BenXinAdmin 后台 5 套可切换主题 + 明暗模式面板

BenXinAdmin 后台 5 套可切换主题 + 明暗模式面板

02

PART


核心功能

核心功能

•代码生成器护城河:php think bx:make 从表结构直出后端 Model/Controller/Service/Validate 四件套 + 路由 + 菜单权限 seeder + 前端列表/表单/分配弹窗

•覆盖三类范式:纯 CRUD、树形(递归 CTE 或内存建树)、授权链路(Casbin 同步 + 事务回滚)

•数据权限五档横切能力,任意模块按需挂载 applyDataScope

•保真回归:生成产物与手写黄金样板逐字一致,可复现校验,杜绝「生成 != 手写」

•安全基线全程贯穿:JWT 双 guard 物理隔离、CasbinRBAC(粒度到按钮)、数据权限五档

•三方密钥 AES 加密入库,git 全历史 0 凭据泄露

•富文本 XSS 净化(后端 HtmlPurifier 白名单)+ 前端渲染转义双重防护

•上传双重校验:真实 MIME + 扩展名白名单 + 目录穿越防护

•支付回调四件套:验签 + 幂等 + 金额二次校验 + 状态机合法迁移

•多维限流防刷:登录/短信限流 + 验证码消费即删 + 错误锁定

•全栈三端:ThinkPHP 8 后端 + Vue 3 后台 + uni-app C 端(一套代码出微信小程序 + H5)

•C 端懒登录:用到核心业务前不强制登录,微信 + 手机号缺一不可

•通用业务底座:内容 CMS / 微信能力 / 支付框架 / 消息(短信·验证码·公告)

•资源合规可商用:未嵌商业字库、图标全开源协议、依赖零 AGPL/GPL 传染

php think bx:make 从表结构直出后端四件套 + 路由 + seeder + 前端全栈产物

php think bx:make 从表结构直出后端四件套 + 路由 + seeder + 前端全栈产物

verify.sh 八标的防污染保真回归全绿(生成 == 黄金样板,仅 @date 差)

verify.sh 八标的防污染保真回归全绿(生成 == 黄金样板,仅 @date 差)

03

PART


技术栈

TECH STACK · 技术选型

层
选型
说明
后端
PHP 8.4 + ThinkPHP 8.1(多应用)
Apache-2.0
数据库
MySQL 8(InnoDB / utf8mb4)
—
缓存
Valkey(Redis 协议兼容)
替 Redis,规避 AGPL 争议
鉴权
lcobucci/jwt 双令牌 + php-casbin
双 guard / 黑白名单
支付
yansongda/pay
锁定版修回调验签 CVE
富文本
ezyang/htmlpurifier
后端净化防 XSS
后台前端
Vue 3.5 + Vite + Element Plus + UnoCSS + Pinia
MIT
C 端
uni-app + Vue3 + TS + wot-design-uni
微信小程序 + H5

04

PART


架构设计

架构设计

BenXinAdmin 采用三个独立仓库(后端 / 后台前端 / C 端),业务边界清晰:开源仓只含用户、权限、系统管理与基础代码生成器,具体业务作独立闭源上层叠加,不进本仓,守开源边界。

后端内部用多应用划分:admin(后台,前缀 /admin)与 api(C 端,前缀 /api)各自独立,公共层(common)沉淀基类、中间件、鉴权与微信/支付/短信等库;统一以业务码返回(code=0 表示成功),让前后端契约一致、错误以 code 为准而非 HTTP 状态码,鉴权类才允许返回 401。

05

PART


项目结构

STRUCTURE · 目录布局

图片

06

PART


快速开始

QUICK START · 快速上手

图片

部署前务必在 .env 设强密码 SUPER_ADMIN_INIT_PWD(不设则不创建超管,无默认弱口令);生产务必 APP_DEBUG=false,避免调试探针与堆栈外泄。

07

PART


适用场景

适用场景

如果你要做一个带后台管理 + 微信小程序/H5 的项目,又不想在「用户体系、权限管理、日志、文件上传、支付、消息」这些公共件上反复投入,BenXinAdmin 就是现成的底座:把这些能力装好,用 php think bx:make 一键长出新模块,你只需聚焦业务代码。

它尤其适合打卡、商城、知识付费这类需要快速验证、又要长期维护的 PHP 项目;三端同源、依赖协议全部可商用,可直接用于商业产品,没有字库 / 图标 / 依赖授权方面的后顾之忧。


群贤毕至

访客