Skip to content

【全新架构】hyperf的后台管理系统,基于jwt权限验证,已实现菜单/API/细粒度权限认证管控、CRUD代码生成。无需写VUE代码即可实现elementUI

Notifications You must be signed in to change notification settings

phonen7/hyperf-admin

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

欢迎加入hyperf-admin交流群,群聊号码:512465490

点击链接加入群聊【hyperf-admin交流群】:群聊号码:512465490

Stable Version Build Status Total Downloads Monthly Downloads Php Version Swoole Version HyperfAdmin License

以插件形式开箱即用

可以做到无需VUE前端可实现快速开发各种表单

后台可视化生成控制器、模型、验证器、View代码等

后台表单、列表生成

喜欢的帮忙点个star

安装 (开发中,线上环境暂时不要使用)

 composer require mzh/hyperf-admin-plugin

发布依赖项目配置

 php bin/hyperf.php vendor:publish mzh/hyperf-swagger
 php bin/hyperf.php vendor:publish mzh/hyperf-jwt

2配置

在 config/autoload/dependencies.php 中 增加以下配置
    return [
        \Hyperf\HttpServer\Router\DispatcherFactory::class => \Mzh\Swagger\DispathcerFactory::class,
    ];

3 配置异常处理器

在 config/autoload/exceptions.php 中 增加以下配置
    return [
        'handler' => [
            'http' => [
                Mzh\Admin\Exception\Handler\AppExceptionHandler::class,
                ...
            ],
        ],
    ];
git clone https://github.com/lphkxd/admin-demo.git   #克隆demo代码

cd admin-demo #进入目录

composer update  #更新依赖

演示地址

演示地址:http://shop.sh.cn/system/index.html

账户名:admin、admin1 密码:admin

Swagger接口文档地址:http://shop.sh.cn/swagger/index#/

Swagger文档地址

Swagger文档地址 http://127.0.0.1:9501/swagger/index

开发计划

  • 模型、控制器、验证器、UI界面生成
  • 接口协议标准化处理
  • 系统配置
  • Swagger注解生成
  • 脚手架工具
  • 菜单管理
  • 角色管理
  • 用户管理
  • 权限管理
  • 任务中心
  • 微信开放平台对接、小程序、公众号管理
  • 微信公众号、小程序对接
  • 多租户模式
  • ...

本项目在 https://hyperf-admin.github.io/hyperf-admin/#/ 基础上优化、并简化处理,搭配验证器,swagger文档,让您开发后台更加迅速、开箱即用

Image 注解 Image 文档 Image 注解 Image 文档

脚手架工具 在控制器只需引用一下代码即可生成对应接口并注册路由、生成Swagger文档。简单易用,无需过多步骤。

以下操作也可以在控制面板可视化生成

- 全功能接口
- 如需要以下全部功能 只需引用  use GetApiAction;

- 自定义选择单项接口
-前端UI接口       只需 use GetApiUi;
-列表            只需 use GetApiList; (钩子中支持增加搜索条件、参数见下文钩子)
-创建            只需 use GetApiCreate; (支持验证提交内容、创建前数据检测、参数见下文钩子)
-删除            只需 use GetApiDelete; 
-批量删除         只需 use GetApiDelete; 
-更新            只需 use GetApiUpdate; 
-排序            只需 use GetApiSort; 
-启用禁用         只需 use GetApiState; 
-单字段内容修改    只需 use GetApiRowChange; 

钩子

  • _ + method 方法 + _before 操作前 主要针对 入参验证、数据重构、字段修改等
  • _ + method 方法 + _after 操作后 主要针对操作后数据返回客户端前的修改,例如数据重构、隐藏字段、删除敏感信息等
0: _list_before       查询列表前
1: _list_after       查询列表后       
2: meddleFormRule       UI表单生成前       
3: beforeFormResponse       UI表单生成后       
4: _update_before       更新前       
5: _update_after       更新后       
6: _create_before       创建前       
7: _create_after       创建后       
8: _sort_before       排序前       
9: _delete_before       删除前       
10: _delete_after       删除后       
11: _state_before       状态更新前       
12: _state_after       状态更新后       

例子

<?php 
declare(strict_types = 1);
namespace App\Controller\Api;

use Mzh\Admin\Controller\AbstractController;
use Mzh\Admin\Traits\GetApiBatchDel;
use Mzh\Admin\Traits\GetApiCreate;
use Mzh\Admin\Traits\GetApiDelete;
use Mzh\Admin\Traits\GetApiList;
use Mzh\Admin\Traits\GetApiRowChange;
use Mzh\Admin\Traits\GetApiSort;
use Mzh\Admin\Traits\GetApiState;
use Mzh\Admin\Traits\GetApiUpdate;
use Mzh\Swagger\Annotation\ApiController;
use Mzh\Swagger\Annotation\Body;
use Mzh\Swagger\Annotation\DeleteApi;
use Mzh\Swagger\Annotation\GetApi;
use Mzh\Swagger\Annotation\PostApi;
use Mzh\Swagger\Annotation\PutApi;
use Mzh\Swagger\Annotation\Query;

/**
 * @ApiController(tag="GroupUser")
 */
class GroupUser
{
    use GetApiList;
    use GetApiCreate;
    use GetApiUpdate;
    use GetApiSort;
    use GetApiState;
    use GetApiDelete;
    use GetApiBatchDel;
    use GetApiRowChange;
    use GetApiList;
    use GetApiUpdate;
    use GetApiCreate;
    use GetApiSort;
    use GetApiDelete;
    use GetApiBatchDel;

    /**
     * 列表查询前操作,这里可用于筛选条件添加、也可在此做权数据权限二次验证等
     */
    public function _list_before(\Mzh\Helper\DbHelper\QueryHelper &$query)
    {
        $query->addData('pid', 0); #追加搜索条件数据
        #以上条件实际输出为  $db->where('pid',0)

        $query->equal('module#tab_id,pid');  #设置查询条件 module、pid以完全匹配   tab_id为接收参数别名
        #以上条件实际输出为  $db->where('module',$data['tab_id'])->where('pid',$data['pid'])


        $query->like('name'); # 设置模糊查询条件  name
        #以上条件实际输出为  $db->whereLike('name','%'.$data['name'].'%')

        $query->timeBetween('create_time'); # 设置时间范围查询
        #以上条件实际输出为  $db->whereBetween('create_time', [$begin, $after])

        $query->in('id,user_id');           #如果请求参数中有 id,user_id 则自动设置条件
        #以上条件实际输出为  $db->whereIn('id',$data['id'])->whereIn('user_id',$data['id'])
        
        #通过以上操作,可轻松在钩子内实现筛选条件处理,
    }

    /**
     * 列表查询后操作,这里可用于列表数据二次编辑
     */
    public function _list_after(&$list)
    {
    }

    /**
     * 更新前操作,这里可以处理提交的参数
     * 这里的参数是已经经过验证器验证的
     * 也可在此做权数据权限二次验证等
     */
    public function _update_before(&$data)
    {
    }

    /**
     * 创建前操作,这里可以处理提交的参数
     * 这里的参数是已经经过验证器验证的
     * 也可在此做权数据权限二次验证等
     */
    public function _create_before(&$data)
    {
    }

    /**
     * 创建后操作,这里可以修改返回的值、例如隐藏字段等操作
     */
    public function _create_after(&$data)
    {
    }

    /**
     * 排序前操作
     * 也可在此做权数据权限二次验证等
     */
    public function _sort_before(&$data)
    {
    }

    /**
     * 删除前操作
     * 也可在此做权数据权限二次验证等
     */
    public function _delete_before($id, &$data)
    {
    }

    /**
     * 删除后操作,这里可以修改返回的值
     */
    public function _delete_after(&$data)
    {
    }

    /**
     * 排序前操作
     * 也可在此做权数据权限二次验证等
     */
    public function _state_before(&$data)
    {
    }

    /**
     * 状态修改后操作,例如删除缓存等
     */
    public function _state_after(&$data)
    {
    }
}
通过以上代码,可以生成如下接口

Image 文档

依赖 & 参考

About

【全新架构】hyperf的后台管理系统,基于jwt权限验证,已实现菜单/API/细粒度权限认证管控、CRUD代码生成。无需写VUE代码即可实现elementUI

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 89.7%
  • PLpgSQL 10.3%