# HPAdmin

**Repository Path**: webman-admin/hpadmin

## Basic Information

- **Project Name**: HPAdmin
- **Description**: 基于webman开发的后台管理系统，可快速生成后台表单，表格等页面，如无定制页面，可无需要触碰任何一行HTML代码即可快速生成页面
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 12
- **Created**: 2022-03-15
- **Last Updated**: 2022-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HPAdmin快速开发系统

HPAdmin是一套渐进式开源后台，基于Webman进行开发为的后台框架，采用前后端分离技术，数据交互采用json格式，功能低耦合高内聚；核心模块支持系统设置、权限管理、管理员、权限菜单、快速构建CRUD功能页面、文档根据注释自动生成API管理等功能。

### 安装步骤

#### 步骤1：下载HPAdmin
码云上直接下载HPAdmin

#### 步骤2：安装HPAdmin
```composer
将代码上传至宝塔站点目录下
```

#### 步骤3：配置http转发
nginx转发源：
```nginx
upstream hpadmin {
  # HPAdmin HTTP Server 的 IP 及 端口
  server 127.0.0.1:39820;
}
```
nginx：
```nginx
    # 配置Vue远程跨域访问组件
    location ~ .*\.(vue)(.*){
        add_header "Access-Control-Allow-Origin"  *;
        add_header "Access-Control-Allow-Methods" "GET, POST, OPTIONS, HEAD";
        add_header "Access-Control-Allow-Headers" "Authorization, Origin, X-Requested-With, Content-Type, Accept";
        if ($request_method = 'OPTIONS'){
            return 204;
        }
    }
    
    # Http
    location / {
        # 将客户端的 Host 和 IP 信息一并转发到对应节点
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        
        # 转发Cookie，设置 SameSite
        proxy_cookie_path / "/; secure; HttpOnly; SameSite=strict";
        # 关闭重试机制
        proxy_next_upstream off;
        
        # 跨域请求
        if ($request_method = OPTIONS) {
            add_header Access-Control-Allow-Origin $http_origin; # 必须要有
            add_header Access-Control-Allow-Headers *; # 必须要有
            add_header Access-Control-Allow-Methods "GET,POST,PUT, DELETE,OPTION"; # 不加也行
            #add_header Access-Control-Allow-Credentials true; # 不加也行
            return 200; # 204也可以，只要返回成功码即可
        }
        
        # 判断是否访问根域名
        if ( -e $request_uri) {
            proxy_pass http://hpadmin;
            break;
        }
        # 执行代理访问真实服务器
        if ( !-e $request_filename ){
            proxy_pass http://hpadmin;
            break;
        }
    }
```
apache规则：
```apache
```
在nginx或apache中增加以上配置文件规则
#### 步骤4：设置目录权限（Linux与mac权限需要设置）
```Linux
设置 public 目录权限为777
设置 runtime 目录权限为777
设置 vendor 目录权限为777
```

#### 步骤5：导入数据库
```env
导入根目录下的hpadmin.sql文件至数据库，数据库为MYSQL 5.7或8
```
#### 步骤5：配置数据库
```env
修改config/thinkorm.php中的数据库连接信息
```

自此所有安装完成，可以进行开发之旅了

### HPAdmins 特性如下
* API文档根据注释在线生成，在线文档预览，文档导出
* 后台多专题主题切换：支持颜色主题和深色模式，页面更加美观
* PHP直接渲染HTML页面，无需碰任何一行HTML代码即可完成后台开发
* 支持远程vue文件开发渲染页面，全后台支持vue页面定制
* 支持多种图标库直接选择使用
* 支持ueditor、wangeditor编辑器
* 动态菜单渲染，直接获取后台权限菜单

### 关于我们
> 官方网站：https://www.hangpu.net

> 在线手册：https://www.kancloud.cn/cyu100235/hpadmin/2379921

> 开发教程：https://www.kancloud.cn/cyu100235/hpadmin/2380864

### 站点演示
后台演示：http://hpadmin.hangpu.net/admin

登录账号：admin

登录密码：123456

### 鸣谢
> 本系统借鉴了uniadmin框架的思路

uniadmin传送门：https://gitee.com/uniadmin/uniadmin

### 引用第三方

> form-create：http://form-create.com/

> php-builder：http://php.form-create.com/