# admin
**Repository Path**: beyondadmin/hyperf-admin
## Basic Information
- **Project Name**: admin
- **Description**: 【全新架构】使用体检和laravel-admin类似，无需写前端vue代码即可实现漂亮的ElementUI框架页面，Auth组件和 laravel的auth 类似支持多用户认证功能，hyperf-admin 插件式快速开发框架
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: v2
- **Homepage**: https://doc.hyperf.plus
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 7
- **Created**: 2021-08-03
- **Last Updated**: 2021-08-03
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
## HPlus Admin
##### 全新admin插件 快速开发框架，以插件形式开箱即用
##### Admin插件使用体验和laravel-admin用法类似，无需VUE前端，可快速开发各种element漂亮的页面。
##### auth组件采用hyperf-auth，目前支持 jwt、session 驱动。用户可以自行扩展。使用体验大体和 laravel 的 auth 类似
##### 灵活可替换的权限验证组件，HPlus提供权限验证，也可以替换自己的权限验证插件
## 文档地址
##### https://doc.hyperf.plus/
## 演示地址：
##### http://shop.sh.cn/auth
##### 账户 admin
##### 密码 admin
#### 欢迎加入HPlus交流群
点击链接加入群聊【hyperf-admin交流群】：群聊号码：512465490
#### laravel版本地址
laravel-vue-admin
### 安装
- 1、安装Admin插件
```bash
Hyperf2.0版本
composer require hyperf-plus/admin:~2.1
Hyperf2.1版本
composer require hyperf-plus/admin:~2.2
```
- 2、生成admin auth file配置文件
```bash
php bin/hyperf.php vendor:publish hyperf-plus/admin
```
- 3、UI资源初始化（建议有修改vue需求的用户，可以查看UI文档，以插件形式开发，尽量不要修改默认的样式，这样后期UI插件有新功能更新也能实现无痛更新）
```bash
php bin/hyperf.php ui:init
```
- 4、配置好数据库（必须），然后执行下面安装命令
```bash
php bin/hyperf.php admin:install
```
- 5、配置异常处理器,可以自行拦截处理，也可以按照以下方式添加异常处理器
#### 在文件 config/autoload/exceptions.php 中添加 \HPlus\Admin\Exception\Handler\AppExceptionHandler::class 异常处理器
```php
[
'http' => [
\HPlus\Admin\Exception\Handler\AppExceptionHandler::class, #放到第一位
# 其他的放到下面
],
],
];
```
- 6、（可选）添加权限控制插件（如果不启用默认权限控制，可以忽略此步骤）
```bash
composer require hyperf-plus/permission
```
#### 默认没有安装权限插件，需要手动安装，此为了更好的扩展，可以自行配置项目已有的权限模块
可在将admin.php 配置文件中权限验证中间件，这样通过注解AdminController注册的路由都会默认加上配置的此中间件
示例代码如下
```php
[
#...省略
'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
[
#...省略
'middleware' => [AuthMiddleware::class, LogsMiddleware::class, 其他中间件],
],
#...省略
]
```
- 8、启动服务
```bash
php bin/hyperf.php start
```
### 访问 http://127.0.0.1:9501/auth
- 账户 admin
- 密码 admin
#### 以插件形式开箱即用
#### 可以做到无需VUE前端可实现快速开发各种表单
### 赞助
#### 1、开源不易，如果此项目能够帮到您，希望点个star
#### 2、欢迎您的捐赠
