auth组件采用hyperf-auth,目前支持 jwt、session 驱动。用户可以自行扩展。使用体验大体和 laravel 的 auth 类似
点击链接加入群聊【hyperf-admin交流群】:群聊号码:512465490
- 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
- 账户 admin
- 密码 admin