RealTpAdmin:基于 ThinkPHP 8 + Layui 的轻量级后台管理系统

项目简介

RealAdmin 是一套基于 ThinkPHP 8LayuiPear 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 依赖

快速安装

  1. 克隆或解压项目到站点目录

  2. 安装 Composer 依赖

    bash 复制代码
    composer install
  3. 设置网站运行目录为 public

  4. 配置伪静态

    • Apache:开启 mod_rewrite
    • Nginx:参考项目文档配置重写规则
    • IIS:直接使用自带的 web.config
  5. 访问安装向导

    复制代码
    http://你的域名/install.php

    填写数据库信息、站点名称和管理员账号即可完成安装。

  6. 访问后台

    复制代码
    http://你的域名/admin.php

开发体验

RealAdmin 在前端封装了 bdFormbdTablebdUploadbdHttp 等常用 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生成,仅供参考)