免登录购买

# 磐石后台 RockAdmin 发布 1.0.1：一套零依赖的原生 PHP 8 后台，把插件做成可以卖的商品

> 从内核、插件机制到市场与授权，这套系统想解决的是「后台交付完之后怎么办」

2026 年 11 月 6 日 · RockAdmin 1.0.1

---

## 导语

RockAdmin（磐石后台）是一套原创的轻量级 PHP 后台管理系统：原生 PHP 8 编写，自研微框架，零 Composer 依赖，代码不引入、不继承任何第三方后台框架的源码，可直接商用。

1.0.1 版本的核心变化不在后台本身，而在**前台**：新增导航栏管理、会员登录后菜单管理、插件前台显示开关，以及插件前台页面自定义路由。配合已有的插件市场与付费授权能力，这套系统现在能跑通一条完整的链路——**装好后台、上架插件、给插件配一个前台入口、按站点签授权收费**。

---

## 一、为什么还要做一套后台管理系统

后台管理系统是个"看起来不缺"的市场：开源方案很多，成熟的商业产品也不少。但真把一套系统交付给客户之后，问题通常从第二个项目开始。

- 每个项目都要重新删演示数据、改菜单、改权限，改到最后和上游代码彻底分叉，无法升级；

- 想加一个业务模块，得先在别人的框架约定里找位置，插件写出来只能自己用；

- 交付给客户的系统里塞满了用不到的功能，出问题定位不到是框架的还是业务的；

- 开发者写了一个插件想卖，却没有分发渠道，只能压缩包加一句"私聊购买"。

RockAdmin 的思路很朴素：**内核做小、约定做死、插件做重、分发做通**。内核只负责引导、路由、请求响应、数据访问、视图、鉴权、缓存、钩子、计划任务这些必须有的东西，业务全部长在插件或模块上。这样内核可以长期不动，交付物永远是"内核 + 客户需要的插件"。

## 二、它是什么

**技术底座**：原生 PHP 8（开发验证环境 8.3），自研微框架，零 Composer 依赖；数据库以 MySQL 5.7/8 为主，SQLite 作为兼容模式，同一套业务代码两种驱动都能跑；前端不使用构建工具，Bootstrap 风格的自绘 CSS 加原生 ES Module。

**代码规模**：框架内核 25 个 PHP 文件、约 6200 行；后台、前台、API、安装向导、公共服务层合计 122 个文件、约 14600 行。所有代码都是本项目原始实现。

**开箱能力**（安装向导点完就有）：

| 能力 | 说明 |

|---|---|

| 安装 | Web 向导：环境检测 → 建表 → 种子数据 → 创建超管；**库里有表时走覆盖安装**，建表一律 `IF NOT EXISTS`，绝不 DROP/ALTER，原有数据一行不动 |

| 权限 | 管理员 / 角色组 / 权限规则树 / 菜单独立规则绑定，超管组保护、成环检测 |

| 菜单 | 树形管理、点击下拉式侧边栏、同级手风琴、按层级缩进、自动展开当前页所在分组；一个插件只占一个顶级条目 |

| 生成器 | 选表 → 解析字段 → 勾选列表/表单/搜索 → 一键生成模型、控制器、视图、权限规则与菜单，生成的代码可自由修改，之后不依赖生成器运行 |

| CRUD 基建 | 软删除与回收站、批量操作、CSV 导入导出、DataTable（排序/分页/搜索/批量） |

| 消息 | 短信与邮件驱动化：阿里云短信（POP HMAC-SHA1 签名）、SMTP（EHLO/AUTH LOGIN/DATA 全握手、STARTTLS、RFC2047 中文头），默认落库 |

| 存储 | 本地存储与 S3 对象存储（AWS SigV4，兼容阿里云 OSS、腾讯云 COS、MinIO，支持 CDN 域名与路径风格） |

| 附件 / 日志 / 任务 | 上传校验与预览、行为日志、五段式 Cron（命令 / URL / SQL 三类，含 CLI 执行器） |

| API | Bearer / X-Token / 参数三种令牌传递，登录换令牌，在线文档 |

| 主题 | 亮色/暗色双主题，CSS 变量驱动，localStorage 持久化，跟随系统偏好，iframe 帧内自动同步 |

## 三、1.0.1 的重点：让前台也能被"运营"

很多后台系统管得住数据，却管不住自己的官网：导航写死在模板里，加一个入口要改代码；会员登录后看不到和业务相关的菜单；自家插件有前台页面，却只能靠一长串参数路由访问。

1.0.1 把这几件事做成了后台可配置项：

**① 导航栏管理** 新增 `front_nav` 表，`nav` 分组是前台顶部导航（游客可见），`member` 分组是会员登录后的头像下拉菜单。标题、地址、排序、启停、是否新窗口打开全部可配；地址填路由路径即可，渲染时自动补全站点子目录前缀，当前页面自动高亮。

**② 会员菜单** 会员登录后才出现的菜单与游客导航分离管理，避免把"我的订单""我的资料"这类入口暴露给未登录访客。

**③ 插件前台显示开关** 插件列表新增"前台"列：带前台页面的插件一键开启，导航栏即时生成入口；关闭即移除。这个开关没有给插件表加字段，而是直接对应导航表里"来源为该插件"的那一行记录——零 schema 迁移，标题和排序还能在导航管理里继续调；插件卸载时自动清理，不留死链。

**④ 插件前台路由** 新表 `addon_route` 提供"首段替换"式入站重写：规则 `fin → finreport/front` 之后，`?s=fin` 进插件前台首页，`?s=fin/user/login` 深链到插件前台登录页。三道防冲突：别名不能与宿主模块或插件目录重名、不能重复、目标控制器必须真实存在；**真实模块永远优先**，原生路由不受影响，别名只影响入站地址，不改 `url()` 生成的链接。

老站升级不需要手工改库：升级程序标记升到 v2，首次请求自动建表、补默认导航、补菜单与权限规则，幂等可重跑。

## 四、插件不只是"装个页面"，是一条从开发到变现的完整链路

RockAdmin 的插件是一个带生命周期的小型应用，不是一个模板片段。

**开发侧**：插件目录 `app/addons/{name}/`，用 `info.json` 声明名称、版本、描述、依赖、钩子、菜单、配置项；主类继承插件基类，实现 install / upgrade / uninstall / enable / disable；可用钩子嵌入 `app_begin`、`app_end`、`attachment_upload_success`。插件可以拥有自己的后台页面（控制器 / 模型 / 视图），自动继承后台同一套登录、CSRF、RBAC 三道闸——**不用自己再写一遍权限**。插件也可以带前台页面与接口：前台基类不套后台外壳，接口基类无页面、无 CSRF、走令牌认证。

后台内置一份 19 章的插件开发文档（目录结构、`info.json` 逐字段、生命周期、路由与控制器、视图与 iframe、DataTable 列表、表单、数据层、权限与菜单、配置、钩子、打包安装、生成器、市场与付费授权、排错对照表、上线清单），其中包大小上限、文件数上限、ZipArchive 是否可用、插件目录是否可写这类参数**从运行时读取**，改了环境文档跟着变。

**分发侧**：后台上传 zip 即可安装、升级、一键回滚。安全上做了四层：扩展名与大小校验、逐条目静态校验加解压后真实路径前缀校验（防 zip slip）、`info.json` 的 name 必须等于目录名、安装前 PHP 语法预检。升级要求版本号更高，旧版自动备份（每插件保留 5 份），失败回滚。插件卸载可选是否删除文件，卸载时菜单、权限节点、权限组里的规则引用一起清干净。

**市场侧**：RockAdmin 内置插件市场客户端，默认连官方市场，零配置。索引里带每个包的 sha256，下载后逐字节校验，不符即删包拒装；索引同时声明版本与运行环境约束（PHP 版本、RockAdmin 版本）。

**付费侧**：这是这套系统和其他后台差别最大的地方。付费插件的授权码是 `RK1.<payload>.<签名>`，用 RSA-SHA256 签发，**站点只持有公钥**，因此即使配置文件泄露也伪造不出授权。判定依据不是本地一个"已购买"标志位，而是市场端的线上购买记录——重装系统、换机器，登录同一站点实例就能取回已购授权，不用重新下单；反过来，改插件 `info.json` 把付费改成免费也绕不过去，因为判据是"声明付费"**或**"本机已有授权记录"。授权失效（被收回、过期、域名不符）会在插件安装入口和插件模块入口两处服务端闸门即时拦下，不是只隐藏一个按钮。

市场站本身是独立的一套 PHP 单入口站（MySQL，SQLite 兼容），负责上架、发版、订单、收款、签发与撤销授权；付款支持微信扫码与支付宝，网关回调一到授权自动签发。两套站不共享代码，只有授权码的字节格式必须一致——这条边界是刻意划的：市场站被攻破也拿不到主站的任何东西，反之亦然。

## 五、拿得出手的插件实例

系统自带的几个插件不是"演示到能点开"的程度，而是完整业务系统：

- **会议管理系统**：24 个后台管理模块（会议、报名审核、议程、专家、日程、场次、座次、签到核销、票种、支付、发票、酒店、接送、展商、考察、资讯、资料、联络员、会员、自定义字段、系统配置、二维码、仪表盘），34 张业务表，19 组 H5 移动端页面，10 个移动端接口控制器，外加一套可直接导入微信开发者工具的 20 余页小程序前端；插件包内同时含小程序源码。

- **财务内控**：预算编制与审批路径、费用报销、借款备用金、采购三单匹配、资金收付、销售回款、应收应付、发票台账、资产、对账核销与审计留痕，30 张业务表，覆盖"从审批到付款、凭证对齐"的端到端流程。

- **在线支付**：把微信支付（APIv3 Native 扫码）与支付宝（当面付 / 电脑网站支付）封装成插件，后台配置参数并做连通性测试，业务代码一行下单，回调自动验签、核对金额并落库。

- **个人工作管理**：工作日志与周报、任务与项目、OKR/KPI、工作计划，全部软删除可追溯。

- **示例插件**：最小可运行的插件骨架，用来读代码理解机制。

## 六、工程上的自我约束

一套后台系统最贵的成本不是写出来，是改的时候不知道会不会踩坏别的地方。RockAdmin 用测试把这件事压住：目前 **1762 项断言**，覆盖安装与登录、权限与菜单、生成器全链路、插件安装/升级/卸载/回滚/孤儿检测、市场与授权（含"改 paid 字段绕过"的阴性验证）、真实网关协议（短信、SMTP、S3 签名由独立桩复算）、主题与前端接线、软删除与 ID 复用回归。

几条具体的纪律：

- 交付的部署包里不允许出现运行数据、安装锁、开发机绝对路径，也不允许带插件源码目录——这些都由构建脚本硬门禁检查，条目数必须与源目录一致；

- 打出来的包会被真解压、真安装、真登录跑一遍，而不是"能解压就算过"；

- 从"页面返回 200"到"按钮能用"之间还有一段距离，前端交互用真实 DOM 契约测试验证，不靠肉眼。

## 七、适合谁

- **中小企业自建后台**：不需要 Composer 生态，不需要 Node 构建链，宝塔面板传上去、建个库、点完向导就能用；

- **外包与集成商**：一次交付一套内核，后续每个客户只装需要的插件；覆盖安装不会破坏已有数据，升级路径清楚；

- **插件开发者**：写一次插件，可以上架市场、按站点授权售卖，分发、收款、授权、撤销都有现成通道；

- **需要私有化部署的团队**：所有依赖都在 PHP 与数据库里，不依赖外部 SaaS，短信/邮件/对象存储都是可切换驱动。

## 八、获取与部署

- 部署包：`dist/rockadmin-1.0.1.zip`（主站，解压后网站根目录指向 `public/`）、`dist/market-server-1.0.1.zip`（市场站，解压即站点根）、`dist/miniprogram-1.0.1.zip`（小程序源码）；

- 环境：PHP 8.0+（含 `pdo_mysql`），MySQL 5.7+ 或 8.0，或安装时改选 SQLite；

- 部署：站点根目录指向 `public/`，Nginx 一条 `try_files $uri $uri/ /index.php?s=$uri&$args;`，确保 `data/` 可写；访问站点自动进入安装向导；

- 升级：替换文件即可，数据库升级由程序幂等执行，不会 DROP 已有表。

---

## 关于 RockAdmin

RockAdmin（磐石后台）是一套原创的轻量级 PHP 后台管理系统，原生 PHP 8 自研微框架，零 Composer 依赖，支持 MySQL 与 SQLite，内置插件机制、插件市场与付费授权。代码全部为本项目原始实现，不引入、不继承任何第三方后台框架源码，可自由商用。