blackteay/ThinkAdmin
1
0
Fork 0
mirror of https://gitee.com/zoujingli/ThinkAdmin.git synced 2025-04-05 19:41:44 +08:00
Code Issues Projects Releases Wiki Activity
4,769 Commits 9 Branches 12 Tags
Go to file
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
邹景立 7c79fe377b 初始化 dev 分支代码
2022-12-30 14:58:34 +08:00
.gitignore
同步跟进Library调整
2022-11-13 12:10:28 +08:00
composer.json
初始化 dev 分支代码
2022-12-30 14:58:34 +08:00
readme.md
初始化 dev 分支代码
2022-12-30 14:58:34 +08:00

readme.md

大道至简 · 原生框架

代码主仓库：https://gitee.com/zoujingli/ThinkAdmin

非常感谢大家一直以来对ThinkAdmin的支持，ThinkAdmin从v1到v6 经历了几次大的调整，但总体都是基于ThinkPHP最新版本为核心在开发，以最简后台为目标而设计。

任何一个系统都不能完全满足所有的业务场景，ThinkAdmin 只做最基础底层的功能，这里包括系统权限管理，系统存储配置，微信授权管理，以及其他常用功能集成等…… 因此ThinkAdmin也被大家定性为外包二开基线系统，目前已经有许多公司及个人在使用（通过数据聚合搜索统计已有3万多在线运行的项目）。

ThinkAdmin v6 基于v1-v5大版本的积累，结合ThinkPHP6 的思维重新构建，减少大量原非必需的组件，自建存储层、服务层及队列任务机制，另外还增加了许多友好指令！ThinkAdmin v6 经历了数个系统实践与测试，不停的调整与优化，目前系统模块及微信模块已经趋于稳定，现将系统管理[admin]及微信管理[wechat] 定为v6内核两大模块并以MIT协议发布，其中微商商城[data]仅作为参考案例不提供技术支持，下载后可直接删除代码和对应数据表，后续可能还有其他模块及相关辅助模块更新发布，敬请期待……

我们致力于二次开发底层框架，提供完整的组件及API，基于此框架可以快速开发应用。ThinkAdmin v6依赖自制组件ThinkLibrary v6 ，封装了大量常用操作，简化编码成本；默认集成WechatDeveloper 组件，支持微信公众号、微信小程序、微信企业号、微信商户支付、支付宝支付接口等。ThinkLibrary组件实现ThinkPHP v6 多应用模式及路由支持，另外还支持本地服务文件存储、七牛云对象存储（支持CDN加速）、又拍云USS存储（支持CDN加速）、阿里云OSS存储（支持CDN加速）、腾讯云COS存储（支持CDN加速）。

另外系统安装及二次开发可以先阅读ThinkPHP官方文档和ThinkAdmin开发文档，若实在无法解决当下问题可以加入官方微信群获得帮助。

注意事项

  • ThinkAdmin是基于国内最流行的ThinkPHP6框架开发，目前对PHP版本要求不得低于PHP 7.2.5 ，如果使用低版本的PHP可能会影响composer依赖组件的安装，存在一定的安全隐患，具体请阅读ThinkPHP更新日志及相关文档；
  • 系统的运行环境必需开启PATHINFO支持并配置对应的rewrite规则才能访问，不再支持ThinkPHP的URL兼容模式运行 ( 源于如何优雅地展示 )，可以阅读文档部署章节；
  • 代码仓库下载的文件不包含composer组件包的vendor目录，下载后需要执行composer install或composer update 安装依赖组件，同时会触发执行数据库Phinx安装脚本；
  • 为保持系统可持续在线升级功能，开发时建议不要在admin,wechat,public/static 这三个目录创建或修改文件，可以自行创建其他模块再编写自己的业务代码，自定义样式及脚本可以放置在目录public/static/extra 里面。系统是基于严格类型PHP新特性开发，务必使用专业的IDE ( 如：PhpStorm,NetBeans,VsCode,Eclipse for PHP等 ) 进行项目开发以达到更好的体验与更高的效率！
  • 若后台操作提示 “演示系统禁止操作” 等字样，需要删除演示路由的配置文件(app/admin/route/demo.php)；

数据管理

A. 注意事项

系统是基于Phinx工具管理数据库，在未配置数据库时默认使用Sqlite数据库database/sqlite.db ，可以作为系统测试与体验；使用Sqlite数据库时仅限用于体验与测试，不得用于生产环境，生产环境建议使用免费开源的MySQL数据库；

B. 数据库初始化安装

使用MySql,SqlServer,Postgres等服务型数据库时，需要先创建空的数据库并将参数配置到config/database.php ，然后执行composer install,composer update或php think migrate:run安装并初始化数据库； 开发部署系统时，如果要对数据库添加数据表或修改数据表，建议创建Phinx脚本后执行composer update 进行数据库更新升级。另外系统也提供php think xadmin:package指令可以把现有MySQl数据库打包为Phinx 安装脚本，迁移系统时只需要执行前面的安装步骤即可。

系统安装

A. 测试或体验环境

  • 系统默认使用Sqlite数据库，不需要配置数据库参数，注意使用Sqlite数据库时是没有密码的。
  • 下载ThinkAdmin系统源码，执行composer install或composer update安装系统依赖组件，会自动安装数据库并初始化所需参数；
  • 执行php think run启动系统内置的WEB服务，用浏览器访问http://127.0.0.1:8000 进入后台登录界面后，使用系统默认的账号[admin]和密码[admin]登录管理后台；也可以使用其他Web服务软件方案实现。

B. 开发或线上环境

  • 下载ThinkAdmin系统源码，安装数据库并创建空的数据库，将数据库参数配置到config/database.php；执行composer install 或composer update安装系统依赖组件，会自动安装数据库并初始化所需参数；
  • 安装Nginx或Apache等Web服务 ( 推荐使用宝塔集成环境 ) ，并按照ThinkPHP6系统要求配置网站参数；当然开发环境也可以使用php think run启动PHP内置的Web服务。

技术支持

开发前请认真阅读 ThinkPHP 官方文档和 ThinkAdmin 开发文档，相信会对您有所帮助哦！

如果实在无法解决您所遇到的问题，可以加入官方群免费交流（需要提交认证信息）。

1.官方QQ交流群： 513350915

2.官方QQ交流群： 866345568

3.官方微信交流群

注解权限

注解权限是指通过方法注释来实现后台 RBAC 授权管理，用注解来管理功能节点。

开发人员只需要写好注释，RBAC 的节点会自动生成，只需要配置角色及用户就可以使用RBAC权限。

  • 此版本的权限使用注解实现
  • 注释必须标准的块注释，如下案例
  • 其中@auth true表示访问需要权限验证
  • 其中@menu true菜单编辑显示可选节点
  • 其中@login true需要强制登录才可访问
/**
* 操作的名称
* @auth true  # 表示访问需要权限验证
* @menu true  # 菜单编辑显示可选节点
* @login true # 需要强制登录才可访问 
*/
public function index(){
   // @todo
}

代码仓库

ThinkAdmin 为 MIT 协议开源系统，安装使用或二次开发不受约束，欢迎 fork 系统。

部分代码来自互联网，若有异议可以联系作者进行删除。

框架指令

  • 执行 build.cmd 可更新 composer 插件，会删除并替换 vendor 目录
  • 执行 php think run 启用本地开发环境，访问 http://127.0.0.1:8000
  • 执行 php think xadmin:fansall 同步微信粉丝数据（依赖于 wechat 模块）
  • 执行 php think xadmin:sysmenu 重写系统菜单并生成新编号并清理已禁用的菜单
  • 执行 php think xadmin:package 将现有MySQL数据库打包为Phinx数据库迁移脚本【新增】
  • 执行 php think xadmin:replace 可以批量替换数据库指定字符字段内容，通常用于文档地址替换
  • 执行 php think xadmin:version 查看当前版本号，显示 ThinkPHP 版本及 ThinkLibrary 版本
  • 执行 php think xadmin:database 对数据库的所有表repair|optimize操作，优化并整理数据库碎片

1. 线上代码更新

  • 执行 php think xadmin:install admin 从线上服务更新 admin 模块的所有文件（注意文件安全）
  • 执行 php think xadmin:install wechat 从线上服务更新 wechat 模块的所有文件（注意文件安全）
  • 执行 php think xadmin:install static 从线上服务更新 static 静态资料文件（注意文件安全）
  • 执行 php think xadmin:install config 从线上服务更新 config 常用配置文件（注意文件安全）

2. 守护进程管理（可自建定时任务去守护监听主进程）

  • 执行 php think xadmin:queue listen [监听]启动异步任务监听服务
  • 执行 php think xadmin:queue start [控制]检查创建任务监听服务（建议定时任务执行）
  • 执行 php think xadmin:queue query [控制]查询当前任务相关的进程
  • 执行 php think xadmin:queue status [控制]查看异步任务监听状态
  • 执行 php think xadmin:queue stop [控制]平滑停止所有任务进程

3. 本地调试管理（可自建定时任务去守护监听主进程）

  • 执行 php think xadmin:queue webstop [调试]停止本地调试服务
  • 执行 php think xadmin:queue webstart [调试]开启本地调试服务（建议定时任务执行）
  • 执行 php think xadmin:queue webstatus [调试]查看本地调试状态

问题修复

  • 增加CORS跨域规则配置，配置参数置放于config/app.php，需要更新ThinkLibrary。
  • 修复layui.table导致基于ThinkPHP模板输出自动转义XSS过滤机制失效，需要更新ThinkLibrary。
  • 修复在模板中使用{:input(NAME)}取值而产生的XSS问题，模板取值更换为{$get.NAME|default=''}。
  • 修复CKEDITOR配置文件，禁用所有标签的on事件，阻止xss脚本注入，需要更新ckeditor/config.js。
  • 修复文件上传入口的后缀验证，读取真实文件后缀与配置对比，阻止不合法的文件上传并存储到本地服务器。
  • 修改JsonRpc接口异常处理机制，当服务端绑定Exception时，客户端将能收到error消息及异常数据。
  • 修改location.hash访问机制，禁止直接访问外部URL资源链接，防止外部XSS攻击读取本地缓存数据。
  • 增加后台主题样式配置，支持全局默认+用户个性配置，需要更新ThinkLibrary,static,admin组件及模块。
  • 后台行政区域数据更新，由原来的腾讯地图数据切换为百度地图最新数据，需要更新static，数据库版需另行更新。
  • 增加Phinx数据库迁移脚本支持，可根据自己的需求安装对应模块，其中admin为改选模块！
  • 从分离SystemService分离出RuntimeService服务，精减服务启动入口，优化性能！

系统版本

体验账号及密码都是 admin

ThinkAdmin v6 基于 ThinkPHP6 开发（后台权限基于注解实现）

ThinkAdmin v5 基于 ThinkPHP 5.1 开发（后台权限基于注解实现）

ThinkAdmin v4 基于 ThinkPHP 5.1 开发（不建议继续使用）

ThinkAdmin v3 基于 ThinkPHP 5.1 开发（不建议继续使用）

ThinkAdmin v2 基于 ThinkPHP 5.0 开发（不建议继续使用）

ThinkAdmin v1 基于 ThinkPHP 5.0 开发（不建议继续使用）

Description
No description provided
Readme 70 MiB
Languages
PHP 99%
Less 1%