IrisAdminApi

演示地址: http://irisadminapi.snowlyg.com

账号/密码 ： username/123456

---

Iris-go 学习交流 QQ 群 ：676717248

微信交流群，请加微信号： snowlyg_china

---

IRIS V12 中文文档

PHP 转 GO 新手问题汇总

希望对初学者能有些帮助！！

项目开发过程详解：

1.Iris-go 项目登陆 API 构建细节实现过程

2.iris + casbin 从陌生到学会使用的过程

---

项目介绍

• iris-go 框架后台接口项目
• gorm 数据库模块
• jwt 的单点登陆认证方式
• cors 跨域认证
• 数据支持 mysql，sqlite3 配置; sqlite3 需要下载 gcc。 gcc 下载地址
• 使用了 https://github.com/snowlyg/gotransformer 转换数据，返回数据格式化，excel 导入数据转换，xml 文件生产数据转换等
• 使用了 https://github.com/snowlyg/easygorm
• 使用 casbin 做权限控制, server/config/rbac_model.conf 为相关配置。系统会根据路由名称生成对应路由权限，并配置到管理员角色。

---

Docker 方式部署

 # 需要安装 docker 
 # application.yml 配置 bindata 为 true
 # application.yml 配置 host 为 0.0.0.0
./build.sh

UPDATE

问题总结

可能遇到的问题

---

1. 运行项目

• 从地址 https://github.com/snowlyg/IrisAdminApi/releases/tag/v0.5 ，选择下载编译好的系统文件,

• 运行项目

# 运行项目
./main 

# 可选参数
-c 配置路径 , 配置文件的绝对路径
-v 打印版本 ,true or false
-s 填充数据，初次启动项目的时候填充基础数据 ,true or false
-p 同步权限，默认 true 
-r 打印路由列表 ,true or false

---

如果需要重新编译项目

• 拉取项目

git clone https://github.com/snowlyg/IrisAdminApi.git

# github 克隆太慢可以用 gitee 地址:

git clone https://gitee.com/snowlyg/IrisAdminApi.git

• 安装项目依赖

加载依赖管理包 (解决国内下载依赖太慢问题) 使用国内七牛云的 go module 镜像。

参考 https://github.com/goproxy/goproxy.cn。

阿里： https://mirrors.aliyun.com/goproxy/

官方： https://goproxy.io/

中国：https://goproxy.cn

其他：https://gocenter.io

golang 1.13 可以直接执行：

go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

---

修改配置文件 application.yml ,配置文件需要放置在运行程序的同级目录

• 前端代码,次项目的前端代码已经移除。

本项目主要是 go-iris 框架的简单使用案例。前端代码的引入增加了本项目的复杂性，不太适合新手学习。

---

• 运行项目

推荐使用 air 或者 gowatch 等热编译工具，直接使用 go run main.go 方法运行，可能会出现配置文件无法加载的问题

如果想使用 go run main.go 命令运行： 可以设置环境变量 TRAVIS_BUILD_DIR=~/go/src/github.com/snowlyg/IrisAdminApi 或者 go run main.go -c ~/go/src/github.com/snowlyg/IrisAdminApi/application.yml, 最后的参数是项目配置文件的绝对路径。

# 安装工具 air    
go get -u github.com/cosmtrek/air
# 不同系统下，配置会不一样。具体配置方法参考 air 说明
cp .air.example.conf .air.conf
air

---

单元测试

http test

# 设置环境变量 TRAVIS_BUILD_DIR=~/go/src/github.com/snowlyg/IrisAdminApi
# 否则无法加载配置文件

# 所有测试
 go test -v ./... -tags test 
 
#单个方法
 go test -run TestUserCreate -v  -tags test 

# 安装工具 gotest 增加测试输出数据颜色
go get github.com/rakyll/gotest@latest

# 测试
 gotest  
 

---

接口文档

自动生成文档 (访问过的接口就会自动成功)

访问文档，从浏览器直接打开 http://localhost:8085/apiDoc

---

登录项目

• http://localhost:8085

感谢

JetBrains 对本项目的支持。