mzh/hyperf-admin-plugin

This package is abandoned and no longer maintained. The author suggests using the hyperf-plus/admin package instead.

开箱即用的Hyperf后台扩展，laravel-admin用法

v2.2.9 2021-09-10 06:49 UTC

Requires

• php: >=7.3
• ext-swoole: >=4.5
• 96qbhy/hyperf-auth: ^2.3
• hyperf-plus/route: ^2.0.0|dev-master
• hyperf-plus/ui: ^1.0.0|dev-master
• hyperf/model-cache: ^2.0.0
• hyperf/paginator: ^2.0.0
• hyperf/redis: ^2.0.0

MIT

• 毛自豪

• admin
• vue
• hyperf

README

全新admin插件 快速开发框架，以插件形式开箱即用

Admin插件使用体验和laravel-admin用法类似，无需VUE前端，可快速开发各种element漂亮的页面。

auth组件采用hyperf-auth，目前支持 jwt、session 驱动。用户可以自行扩展。使用体验大体和 laravel 的 auth 类似

灵活可替换的权限验证组件，HPlus提供权限验证，也可以替换自己的权限验证插件

文档地址

https://hyperf-plus.gitee.io/wiki/#/

欢迎加入HPlus交流群

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

laravel版本地址

laravel-vue-admin

安装

• 1、安装Admin插件

     Hyperf2.0版本
    composer require hyperf-plus/admin:~2.1

    Hyperf2.1版本
    composer require hyperf-plus/admin:~2.2

• 2、生成admin auth file配置文件

    php bin/hyperf.php vendor:publish hyperf-plus/admin

• 3、UI资源初始化（建议有修改vue需求的用户，可以查看UI文档，以插件形式开发，尽量不要修改默认的样式，这样后期UI插件有新功能更新也能实现无痛更新）

    php bin/hyperf.php ui:init

• 4、配置好数据库（必须），然后执行下面安装命令

    php bin/hyperf.php admin:install

• 5、配置异常处理器,可以自行拦截处理，也可以按照以下方式添加异常处理器

在文件 config/autoload/exceptions.php 中添加 \HPlus\Admin\Exception\Handler\AppExceptionHandler::class 异常处理器

    <?php
        return [
            'handler' => [
                'http' => [
                    \HPlus\Admin\Exception\Handler\AppExceptionHandler::class, #放到第一位
                 # 其他的放到下面
                ],
            ],
        ];

• 6、（可选）添加权限控制插件（如果不启用默认权限控制，可以忽略此步骤）

  composer require hyperf-plus/permission

默认没有安装权限插件，需要手动安装，此为了更好的扩展，可以自行配置项目已有的权限模块

可在将admin.php 配置文件中权限验证中间件，这样通过注解AdminController注册的路由都会默认加上配置的此中间件 示例代码如下

<?php
return [
    #...省略
    'route' => [
        #...省略
        'middleware' => [AuthMiddleware::class,自己的权限验证中间件],
    ],
    #...省略
    ]

需要验证权限的地方用AdminController注解路由来定义，或者添加中间件PermissionMiddleware即可
此插件支持注解路由插件 hyperf-plus-route插件的注解参数
如：控制器注解：ApiController
方法注解：GetApi PostApi PutApi DeleteApi （方法上配置级别优先于控制器配置）
1、userOpen 对用户开放url中的验证，
2、security 为true必须验证权限 false公共开放资源
路由注解只在启动第一次时扫描并缓存，后续请求不会再做解析，提高性能

• 7、（可选）日志记录，添加日志管理中间件，日志记录功能数据量较大，默认不开启（如需开启在admin配置文件的route节点下middleware添加LogsMiddleware中间件即可 ） 或者在需要加日志的接口，注解上LogsMiddleware中间件即可记录

<?php
return [
    #...省略
    'route' => [
        #...省略
        'middleware' => [AuthMiddleware::class, LogsMiddleware::class, 其他中间件],
    ],
    #...省略
    ]

• 8、启动服务

	php bin/hyperf.php start

访问 http://127.0.0.1:9501/auth

• 账户 admin
• 密码 admin

以插件形式开箱即用

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

赞助

1、开源不易，如果此项目能够帮到您，希望点个star

2、欢迎您的捐赠

鸣谢

协议

MIT 许可证（MIT）。有关更多信息，请参见协议文件。