ThinkAdmin/README.md
2019-08-24 14:21:46 +08:00

134 lines
6.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 大道至简 · 原生框架
ThinkAdmin V5 是一个基于 ThinkPHP 5.1 开发的后台管理系统。
我们致力于二次开发底层框架提供完整的组件及API基于此框架可以快速开发应用。
另外项目安装及二次开发可以参考 ThinkPHP 官方文档,数据库文件摆放在项目根目录下。
ThinkAdmin 非常适用快速二次开发,默认集成 微信开发组件支持微信服务号、微信支付、支付宝支付、阿里云OSS存储、七牛云存储、本地服务器存储等。
后台UI基于最新版本的 LayUI 及 RequireJs 加载第三方插件(建议自行了解 LayUI 及 RequireJs
#### 注意事项
* 项目测试需要自行搭建环境导入数据库( admin_v5.sql )并修改配置( config/database.php )
* 若操作提示“演示系统禁止操作”等字样,需要删除演示路由配置( route/demo.php )或清空路由文件;
* 当前版本使用 ThinkPHP 5.1.x对 PHP 版本标注不低于 PHP 5.6,具体请阅读 ThinkPHP 官方文档;
* 环境需开启 PATHINFO不再支持 ThinkPHP 的 URL 兼容模式运行(源于如何优雅的展示);
## 技术支持
开发文档http://doc.thinkadmin.top/thinkadmin-v5
开发前请认真阅读 ThinkPHP 官方文档会对您有帮助哦!
本地开发命令`php think run`,使用`http://127.0.0.1:8000`访问项目。
PHP 开发技术交流( QQ 群 513350915
[![PHP微信开发群 (SDK)](http://pub.idqqimg.com/wpa/images/group.png)](http://shang.qq.com/wpa/qunwpa?idkey=ae25cf789dafbef62e50a980ffc31242f150bc61a61164458216dd98c411832a)
## 注解权限
注解权限是指通过方法注释来实现后台RBAC授权管理用注解来管理功能节点。
开发人员只需要写好注释RBAC的节点会自动生成只需要配置角色及用户就可以使用RBAC权限。
* 此版本的权限使用注解实现
* 注释必需使用标准的块注释,如下案例
* 其中`@auth true`表示访问需要权限验证
* 其中`@menu true`显示在菜单编辑的节点可选项
```php
/**
* 操作的名称
* @auth true # 表示需要验证权限
* @menu true # 在菜单编辑的节点可选项
*/
public function index(){
// @todo
}
```
## 代码仓库
ThinkAdmin 为 MIT 协议开源项目,安装使用或二次开发不受约束,欢迎 fork 项目。
部分代码来自互联网,若有异议可以联系作者进行删除。
* 在线体验地址https://demo.thinkadmin.top (账号和密码都是 admin
* Gitee仓库地址https://gitee.com/zoujingli/ThinkAdmin
* GitHub仓库地址https://github.com/zoujingli/ThinkAdmin
## 框架指令
* 执行 `build.cmd` 可更新 `Composer` 插件,会删除并替换 `vendor` 目录
* 执行 `php think run` 启用本地开发环境,访问 `http://127.0.0.1:8000`
#### 1. 线上代码更新
* 执行 `php think xsync:admin` 从线上服务更新 `admin` 模块的所有文件(注意文件安全)
* 执行 `php think xsync:wechat` 从线上服务更新 `wechat` 模块的所有文件(注意文件安全)
* 执行 `php think xsync:service` 从线上服务更新 `service` 模块的所有文件(注意文件安全)
* 执行 `php think xsync:plugs` 从线上服务更新 `plugs` 静态插件的部分文件(注意文件安全)
* 执行 `php think xsync:config` 从线上服务更新 `config` 项目配置的部分文件(注意文件安全)
#### 2. 微信资料管理
* 执行 `php think xfans:all` 更新已经对接的公众号全部列表
* 执行 `php think xfans:list` 更新已经对接的公众号粉丝列表
* 执行 `php think xfans:tags` 更新已经对接的公众号标签列表
* 执行 `php think xfans:black` 更新已经对接的公众号黑名单列表
#### 3. 守护进程管理
* 执行 `php think xtask:listen` 启动异步任务监听守护主进程
* 执行 `php think xtask:query` 查询正在执行的所有任务进程
* 执行 `php think xtask:start` 创建异步任务监听守护主进程
* 执行 `php think xtask:state` 查看异步任务监听主进程状态
* 执行 `php think xtask:stop` 平滑停止异步任务所有的进程
#### 4. 其它自定工具
* 执行 `php think xclean:session` 清理无效的会话SESSION文件
* 执行 `php think xclean:store` 清理无效的订单信息及定时任务
## 特别感谢
|名称|描述|
|---|---|
|layui|后台基础UI组件库|
|ckeditor|后台富文本编辑器|
|awesome|后台扩展字体图标库|
|pluploader|后台文件上传工具|
|ThinkPHP|PHP基础支持框架|
|ThinkLibrary|ThinkPHP扩展组件|
|WeChatDeveloper|微信开放工具组件|
|WeOpenDeveloper|微信开放平台组件|
## 赞助打赏
![赞助](http://static.thinkadmin.top/pay.png)
## 项目版本
体验账号及密码都是`admin`
#### ThinkAdmin v1 基于 ThinkPHP 5.0 开发
* 在线体验地址https://v1.thinkadmin.top
* Gitee 代码地址https://gitee.com/zoujingli/ThinkAdmin/tree/v1
* Github 代码地址https://github.com/zoujingli/ThinkAdmin/tree/v1
#### ThinkAdmin v2 基于 ThinkPHP 5.0 开发
* 在线体验地址https://v2.thinkadmin.top
* Gitee 代码地址https://gitee.com/zoujingli/ThinkAdmin/tree/v2
* Github 代码地址https://github.com/zoujingli/ThinkAdmin/tree/v2
#### ThinkAdmin v3 基于 ThinkPHP 5.1 开发
* 在线体验地址https://v3.thinkadmin.top
* Gitee 代码地址https://gitee.com/zoujingli/ThinkAdmin/tree/v3
* Github 代码地址https://github.com/zoujingli/ThinkAdmin/tree/v3
#### ThinkAdmin v4 基于 ThinkPHP 5.1 开发
* 在线体验地址https://v4.thinkadmin.top
* Gitee 代码地址https://gitee.com/zoujingli/ThinkAdmin/tree/v4
* Github 代码地址https://github.com/zoujingli/ThinkAdmin/tree/v4
#### ThinkAdmin v5 基于 ThinkPHP 5.1 开发(后台权限基于注解实现)
* 在线体验地址https://v5.thinkadmin.top
* Gitee 代码地址https://gitee.com/zoujingli/ThinkAdmin/tree/v5
* Github 代码地址https://github.com/zoujingli/ThinkAdmin/tree/v5