HuiCMF v6.0

【基于ThinkPHP6.0和layui的快速开发的后台管理系统。】

用于学习并允许商业使用。

运行环境要求PHP7.2+(兼容PHP8.0)，Redis。

数据库要求：mysql5.5+，推荐5.7。

编辑器使用了 editor.md | UEeditor | icEditor

支持插件安装，（使用了think-addons扩展插件）

系统默认缓存方式为redis。请先安装并开启redis。

如果不想使用redis，请更改根目录.evn文件中DRIVER = redis的值为file

安装

• 首先：git clone 获取数据
• 然后：composer update 更新数据
• 接着：根目录 .example.env 复制一份重命名：.env（去掉.example）
• 访问： http://你的域名/install
• 执行安装程序
• 最后访问后台：http://你的域名/admin.php
• 默认后台账号密码： admin admin888

后台演示

https://huicmf6.xiaohuihui.net/admin.php

账号：admin

密码：admin888

使用说明

1、后台控制器都需要继承：AdminController

2、使用了注解权限：

注解权限

注解权限只能获取后台的控制器，也就是该app/admin/controller下

控制器注解权限

控制器类注解tag @ControllerAnnotation

• 注解类： HuiCMF\annotation\ControllerAnnotation
• 作用范围： CLASS
• 参数说明： title 控制器的名称（必填） auth 是否开启权限控制，默认为true （选填，Enum:{true, false}）

示例

备注：注解前请先引用： use app\admin\annotation\ControllerAnnotation;

/**
 * @ControllerAnnotation(title="菜单管理")
 * Class Node
 * @package app\admin\controller\system
 */
class MenuController extends AdminController
{

}

方法节点注解权限

方法节点类注解tag @NodeAnotation

• 注解类： HuiCMF\annotation\NodeAnotation
• 作用范围： METHOD
• 参数说明： title 方法节点的名称（必填） auth 是否开启权限控制，默认为true （选填，Enum:{true, false}）

示例：

备注：注解前请先引用： use app\admin\annotation\NodeAnotation;

/**
 * @NodeAnotation(title="菜单列表")
 */
public function index()
{
}

3、方法中重写了url()，为__url()

所有原方法中的url()不要使用，要使用__url()方法来处理路由。

目的：隐藏模块名（admin）、后台入口。

更改为：http://你的域名/admin.php (admin.php可以自定义)

后台前端问题

1、前端auth权限验证

为什么前端也做权限认证，权限认证不应该是后端做的吗？ 这里的权限认证指的是前端判断是否有权限查看的数据（例如：添加、删除、编辑之类的按钮），这些只有在点击到对应的url之后，后端才会进行权限认证。 为了避免用户困扰，可以在此用上前端的权限认证，判断是否显示还是隐藏

第一种示例, 通过php的auth()方法生成layui-hide样式属性。

<a class="layui-btn layui-btn-sm layui-btn-normal {if !check_auth('system.admin/edit')}layui-hide{/if}" data-open="{:__url('system.admin/edit')}?id={{d.id}}"
               data-title="编辑管理">编辑</a>

第二种, 通过php的auth()方法判断, 是否显示html

{if check_auth('system.admin/edit')}
<a class="layui-btn layui-btn-sm layui-btn-normal " data-open="{:__url('system.admin/edit')}?id={{d.id}}"
               data-title="编辑管理">编辑</a>
{/if}

2、按钮属性

data-open：弹出层打开:width:90%，height:80%

data-open-full：弹出层打开全屏:width:100%，height:100%

data-confirm：普通询问对话框

data-delete：删除询问对话框

• data-reload="1" 刷新父级页面【例如点击编辑按钮弹出窗口后保存或者关闭窗口在列表页（父级）页面刷新。默认不写或者 data-reload="0"为不刷新】
• data-reload="2" 刷新当前页面【例如点击编辑按钮弹出窗口后保存或者关闭窗口在当前页面刷新。默认不写或者 data-reload="0"为不刷新】 【实例：】

//弹出层打开:width:90%，height:80%
<a href="javascript:;" data-open="{:__url('system.node/index')}" data-title="测试编辑打开" data-reload="1">编辑</a>

//弹出层打开全屏:width:100%，height:100%
<a href="javascript:;" data-open-full="{:__url('system.node/index')}" data-title="测试添加打开">添加</a>

//删除询问对话框
<a href="javascript:;" data-delete="{:__url('system.node/index')}" data-title="您确定要删除吗？">1231232313</a>

//普通询问对话框
<a href="javascript:;" data-confirm="{:__url('system.node/index')}" data-title="您确定要取消收藏吗？">1231232313</a>

3、上传图片（附件）

案例页面：http://你的域名/admin.php/system.test/upload.html

1、在页面中直接使用layui上传

<!--html-->
<button type="button" class="layui-btn" id="test1"><i class="layui-icon"></i>上传图片</button>

/*javascript*/
upload.render({
  elem: '#test1'
  , url: "{:__url('upload/index',['save_path'=>'images'])}"
  , done: function (res) {
    if (res.code === 1) {
      $("#image").val(res.url);
    }
  }
})

2、使用封装好的layui上传（只需要一个按钮，无需在页面中写js）

使用案例：

<button type="button" class="layui-btn layui-btn-normal layUpload" id="lay_pic" data-input-id="c-pic" data-type="image">
    <i class="layui-icon"></i>上传图片
</button>

以上代码中国注释如下：

| 参数名 |是否允许为空| 参数值| | ------------ | ------------ | | class | 否 |layUpload [必填一致]| | id | 否 |例如：lay_pic| | data-input-id | 否 |图片文本框的id值，用于返回url填充| | data-type | 是 |image [图片格式]；file [附件格式]|

3、使用封装好的webUploader插件上传（只需要一个按钮，无需在页面中写js）

参数同上

<button type="button" class="webUpload" id="picker_pic" data-multiple="false" data-input-id="c-pic"
        data-preview-id="p-pic" data-type="image"><i class="layui-icon"></i>上传图片
</button>

4、二开了think-addons扩展插件

插件基于：zzstudio/think-addons 进行了二开处理

1. 在helper助手中增加了部分公共方法
2. 修改了Addons.php文件，方便在程序中二次调用
3. 插件文件夹里：

• 插件名要和插件控制器一直，例如： test插件文件夹里的 Test.php文件
• info.ini 一定要有，而且字段要对应
• config.php文件参数 参考 test插件里的

5、后台表单省市区域三级联动

<div class="layui-form-item tpl-district-container">
    <label class="layui-form-label">地区</label>
    <div class="layui-inline">
        <select name="province" lay-filter="tpl-province" data-value="" class="form-control tpl-province">
        </select>
    </div>
    <div class="layui-inline">
        <select name="city" lay-filter="tpl-city" data-value="" class="form-control tpl-city">
        </select>
    </div>
    <div class="layui-inline">
        <select name="area" lay-filter="tpl-district" data-value="" class="form-control tpl-district">
        </select>
    </div>
</div>

之后在layui里引用一下即可。其中 data-value 属性是用于编辑的赋值

6、【小插件】-让数字动起来

<span class="number-timer">66</span>

layui.use(['jquery', 'miniCountUp'], function () {
  var $ = layui.jquery;
  var countUp = layui.miniCountUp;
  var count_up = new countUp({
    target: $('.number-timer'),
    startVal: 0, //目标开始的值，默认值为0
    endVal: 3, //到达目标值,默认值为元素的值
    decimals: 0, //小数位数，默认值为0
    duration: 1.5, //动画持续时间为秒，默认值为2
  });
  count_up.start();
});

接口文档（apidoc）

接口文档使用了apidoc

https://hg-code.gitee.io/thinkphp-apidoc/

总结注意事项（爬坑）：

安装：

使用composer安装：

composer require hg/apidoc

前端访问：

http://你的域名/apidoc

如果无法访问请查看伪静态是否正确

前端接口异常：

请检查路径是否正确

基础案例：

1. 配置config/apidoc.php文件
2. 案例控制器文件：app/api/controller/UserController.php

特别感谢

以下项目排名不分先后

• ThinkPHP：https://github.com/top-think/framework
• EasyAdmnin：https://gitee.com/zhongshaofa/easyadmin
• Layuimini：https://github.com/zhongshaofa/layuimini
• Annotations：https://github.com/doctrine/annotations
• Layui：https://github.com/sentsin/layui
• Jquery：https://github.com/jquery/jquery
• NKeditor：https://gitee.com/blackfox/NKeditor
• CKEditor：https://github.com/ckeditor/ckeditor4
• JetBrains：https://jb.gg/OpenSourceSupport

版权信息

HuiCMF遵循Apache2.0开源协议发布，并允许商业使用。 本项目包含的第三方源码和二进制文件之版权信息另行标注。 版权所有Copyright © 2019-2022 by xiaohuihui (https://xiaohuihui.net.cn) All rights reserved。

免责声明

HuiCMF遵循Apache2.0开源协议发布，并允许商业使用。任何用户在使用HuiCMF后台框架前，请您仔细阅读并透彻理解本声明。您可以选择不使用HuiCMF后台框架，若您一旦使用HuiCMF后台框架，您的使用行为即被视为对本声明全部内容的认可和接受。

• HuiCMF后台框架是一款开源免费的后台快速开发框架 ，主要用于更便捷地开发后台管理；其尊重并保护所有用户的个人隐私权，不窃取任何用户计算机中的信息。更不具备用户数据存储等网络传输功能。
• 您承诺秉着合法、合理的原则使用HuiCMF后台框架，不利用HuiCMF后台框架进行任何违法、侵害他人合法利益等恶意的行为，亦不将HuiCMF后台框架运用于任何违反我国法律法规的 Web 平台。
• 任何单位或个人因下载使用HuiCMF后台框架而产生的任何意外、疏忽、合约毁坏、诽谤、版权或知识产权侵犯及其造成的损失 (包括但不限于直接、间接、附带或衍生的损失等)，本开源项目不承担任何法律责任。
• 用户明确并同意本声明条款列举的全部内容，对使用HuiCMF后台框架可能存在的风险和相关后果将完全由用户自行承担，本开源项目不承担任何法律责任。
• 任何单位或个人在阅读本免责声明后，应在《MIT 开源许可证》所允许的范围内进行合法的发布、传播和使用HuiCMF后台框架等行为，若违反本免责声明条款或违反法律法规所造成的法律责任(包括但不限于民事赔偿和刑事责任），由违约者自行承担。
• 如果本声明的任何部分被认为无效或不可执行，其余部分仍具有完全效力。不可执行的部分声明，并不构成我们放弃执行该声明的权利。
• 本开源项目有权随时对本声明条款及附件内容进行单方面的变更，并以消息推送、网页公告等方式予以公布，公布后立即自动生效，无需另行单独通知；若您在本声明内容公告变更后继续使用的，表示您已充分阅读、理解并接受修改后的声明内容。