项目简介
RealAdmin 是一套基于 ThinkPHP 8 、Layui 和 Pear Admin 构建的后台管理系统,定位是开箱即用的快速开发框架。项目地址:https://gitee.com/jinan-jimeng-network_0/real-tp-admin。
后期会增加很多插件,目前已经有了crud和富文本编辑器
它内置了后台登录、RBAC 权限管理、管理员管理、会员体系、系统配置、附件管理、数据库备份还原、模块/插件管理等常用后台能力,适合中小型 Web 项目的后台快速搭建。
技术栈
| 层面 | 技术选型 |
|---|---|
| 后端框架 | ThinkPHP 8.1 |
| ORM | ThinkORM 4.0 |
| 前端 UI | Layui |
| 后台模板 | Pear Admin |
| 数据库 | MySQL 5.7+ / 8.0 |
| 依赖管理 | Composer |
| PHP 版本 | >= 8.0.2 |
核心 Composer 依赖包括 phpmailer/phpmailer(邮件)、phpoffice/phpspreadsheet(Excel 导入导出)、nelexa/zip(压缩)、topthink/think-captcha(验证码)等。
核心功能
- RBAC 权限管理:菜单、权限规则、角色组三级权限体系,管理员可精细化控制后台访问范围。
- 会员体系:用户、用户组、用户等级三级结构。
- 系统配置:可视化的配置管理页面,支持文本、图片、开关、下拉、富文本等十余种配置类型,配置项按分组展示。
- 附件管理:上传、选择、预览一体化附件组件,支持单文件和多文件。
- 数据库备份还原:后台一键备份和还原,降低数据运维门槛。
- 插件机制:完整的插件生命周期管理(安装/卸载/启用/禁用/升级),支持本地和远程插件市场。插件可携带控制器、模型、视图、静态资源和数据库表,启用后自动合并到项目目录。
- 安装向导 :通过
install.php引导式初始化项目,填写数据库和管理员信息即可完成部署。
项目目录结构
app/ 应用目录
├── admin/ 后台应用(控制器/模型/视图/语言包)
├── api/ API 应用
├── common/ 公共控制器、模型、函数库
├── index/ 前台应用
addons/ 插件目录
config/ 配置文件(数据库、系统核心配置)
extend/ 扩展类库(插件管理器、安装器)
public/ Web 入口(index.php / admin.php / install.php)
vendor/ Composer 依赖
快速安装
-
克隆或解压项目到站点目录
-
安装 Composer 依赖
bashcomposer install -
设置网站运行目录为
public -
配置伪静态
- Apache:开启
mod_rewrite - Nginx:参考项目文档配置重写规则
- IIS:直接使用自带的
web.config
- Apache:开启
-
访问安装向导
http://你的域名/install.php填写数据库信息、站点名称和管理员账号即可完成安装。
-
访问后台
http://你的域名/admin.php
开发体验
RealAdmin 在前端封装了 bdForm、bdTable、bdUpload、bdHttp 等常用 Layui 组件,开发后台 CRUD 页面时模板代码量大幅减少:
- 表单页 :继承
layout/form布局,字段写入row[]数组,绑定了自动提交、校验、附件上传和选择。 - 列表页 :
bdTable.render()一行配置即可生成带搜索、排序、批量操作、行内编辑的表格。 - 内置格式化器:状态标签、图片预览、开关组件、时间格式等开箱即用。
后端控制器继承 Backend 基类后,配合 buildparams() 方法可快速实现分页查询和搜索。
插件开发
RealAdmin 的插件系统是核心亮点。每个插件是一个独立的目录,放在 addons/ 下,标准结构如下:
addons/mymodule/
├── Mymodule.php 插件主类(定义生命周期钩子)
├── info.ini 插件信息(名称/版本/作者)
├── install.sql 安装 SQL(可选)
├── menu.php 后台菜单配置(可选)
├── app/ 应用代码(启用时合并到项目 app/)
├── public/ 静态资源(启用时合并到项目 public/)
└── template/ 模板文件
插件主类通过 install()、enable()、disable()、uninstall()、upgrade() 等方法控制生命周期,AppInit() 则在每次请求时执行,适合注册路由和事件监听。
适用场景
- 企业内部管理系统快速搭建
- PHP 初学者学习 ThinkPHP 8 和 RBAC 权限模型
- 需要插件化架构的中小型 Web 项目
- 外包项目的后台基础框架
总结
RealAdmin 是一套务实、不花哨的后台框架。它的优势在于 ThinkPHP 8 的现代化特性 + Layui 的低学习成本 + 完整的插件体系,让开发者可以专注于业务逻辑而非重复造轮子。如果你正在找一个国产免费、文档齐全的 PHP 后台框架,RealAdmin 值得一试。
(内容由AI生成,仅供参考)