大家好,欢迎访问GoFrame框架的快速章节!由于GoFrame是一款模块化、低耦合设计的开发框架,包含了常用的基础组件和开发工具,既可以作为完整的业务项目框架使用也可以作为独立的组件库使用。我们为大家提供的快速开始章节,主要以完整的业务项目介绍框架的基本入门和使用。关于独立组件库使用,可以查看独立的组件章节介绍。

在进一步开始之前请您注意,由于GoFrame算得上真正意义的Golang企业级、工程化的开发框架,她设计严谨、易于使用、文档丰富且社区活跃,一旦您学习并掌握了框架的使用,您将难以回到过去刀耕火种的开发年代

如果还没有安装/配置好Golang开发环境的小伙伴,可以先参考下Golang环境搭建:准备工作

视频教程💖

🐸 赛,我在社区中发现有同学居然做了挺不错的入门系列视频教程💖,因此贴到快速开始教程的最前面分享给大家,新来的同学可以直接看视频教程,随后再看看后续章节,可以事半功倍https://www.bilibili.com/video/BV1Uu4y1u7kX

安装框架工具

框架提供的开发工具为开发者提供了便捷的开发指令简化开发工作,提供了例如工程脚手架、代码自动生成、工具及框架更新等实用命令。

工具下载地址:https://github.com/gogf/gf/releases

预编译安装

预编译安装是开源社区预编译好的二进制文件,供开发者直接使用,二进制文件托管存放到github仓库中。

Mac环境

  1. wget -O gf "https://github.com/gogf/gf/releases/latest/download/gf_$(go env GOOS)_$(go env GOARCH)" && chmod +x gf && ./gf install -y && rm ./gf

您可能会遇到以下常见问题:

  • 如果当前系统没有安装wget命令,那么请使用brew install wget安装后继续执行该命令。
  • 🔥如果您使用的是zsh终端,可能会存在gf别名冲突(git fetch快捷指令),那么安装后(至少执行一次)请重启终端软件来继续使用。

Linux环境

  1. wget -O gf "https://github.com/gogf/gf/releases/latest/download/gf_$(go env GOOS)_$(go env GOARCH)" && chmod +x gf && ./gf install -y && rm ./gf

如果系统没有安装wget命令:

  • Ubuntu/Debian系统请使用 apt-get install wget -y
  • CentOS/RedHat系统请使用 yum install wget -y

Windows环境

手动下载对应的二进制文件,双击按照终端指令安装即可。如果双击安装失败,请采用最后万能的手动编译安装方式。

手动编译安装

通过下载源码到本地编译生成二进制后安装到系统目录,这是万能的安装方式:

  1. git clone https://github.com/gogf/gf && cd gf/cmd/gf && go install

验证安装成功

执行gf -v指令如果能打印出例如以下信息,表示您已成功安装好了框架工具 👍

  1. $ gf -v
  2. GoFrame CLI Tool v2.1.3, https://goframe.org
  3. GoFrame Version: cannot find goframe requirement in go.mod
  4. CLI Installed At: /Users/john/Workspace/Go/GOPATH/bin/gf
  5. CLI Built Detail:
  6. Go Version: go1.17.13
  7. GF Version: v2.1.3
  8. Git Commit: 2022-08-22 14:40:48 91d8d71821012aef4a35b5f9e7b4fbfc04f3ffe7
  9. Build Time: 2022-08-22 14:48:37

注意其中的Go/GF Version是当前编译的二进制文件使用的GolangGoFrame框架版本,其中的GoFrame Version是当前项目使用的GoFrame框架版本(自动检测当前目录下的go.mod)。

常见问题注意事项:🔥如果您使用的是zsh终端,可能会存在gf别名冲突(git fetch快捷指令),那么安装后(至少执行一次)请重启终端软件来继续使用。

创建项目模板

  1. gf init demo -u

该命令创建一个工程脚手架目录,项目名称是demo,其中的-u参数用户指定是否更新项目中使用的goframe框架为最新版本。框架有独特的项目工程结构,工程目录结构介绍具体请参考:工程目录设计??

框架的脚手架目录是按照通用性设计的,可以满足WEB、终端、微服务等业务开发场景。默认会生成一个HTTP Web Server的模板项目。在理解完成目录含义后,如果其中有不需要的目录,可以自行删除。

快速开始 - 图1

运行项目模板

项目模板可以执行以下命令运行:

  1. cd demo && gf run main.go

其中的gf run是框架开发工具的动态编译命令,也可以替换为go run命令。

执行后,终端输出:

  1. $ cd demo && gf run main.go
  2. build: main.go
  3. go build -o ./main main.go
  4. ./main
  5. build running pid: 76159
  6. 2022-08-22 12:20:59.058 [INFO] swagger ui is serving at address: http://127.0.0.1:8000/swagger/
  7. 2022-08-22 12:20:59.058 [INFO] openapi specification is serving at address: http://127.0.0.1:8000/api.json
  8. 2022-08-22 12:20:59.059 [INFO] pid[76159]: http server started listening on [:8000]
  9. ADDRESS | METHOD | ROUTE | HANDLER | MIDDLEWARE
  10. ----------|--------|------------|-----------------------------------------------------------------|----------------------------------
  11. :8000 | ALL | /* | github.com/gogf/gf/v2/net/ghttp.internalMiddlewareServerTracing | GLOBAL MIDDLEWARE
  12. ----------|--------|------------|-----------------------------------------------------------------|----------------------------------
  13. :8000 | ALL | /api.json | github.com/gogf/gf/v2/net/ghttp.(*Server).openapiSpec |
  14. ----------|--------|------------|-----------------------------------------------------------------|----------------------------------
  15. :8000 | GET | /hello | demo/internal/controller.(*cHello).Hello | ghttp.MiddlewareHandlerResponse
  16. ----------|--------|------------|-----------------------------------------------------------------|----------------------------------
  17. :8000 | ALL | /swagger/* | github.com/gogf/gf/v2/net/ghttp.(*Server).swaggerUI | HOOK_BEFORE_SERVE
  18. ----------|--------|------------|-----------------------------------------------------------------|----------------------------------

默认情况下项目会设置Web服务端口为8000、开启OpenAPI接口文档、展示Swagger接口文档页面,这些关键信息都会展示到终端。默认情况下,会打印所有的路由信息到终端,该项目模板只会添加一个仅供演示的路由:/hello

默认路由: http://127.0.0.1:8000/hello

快速开始 - 图2

Swagger接口文档页面:

快速开始 - 图3

升级框架版本

随时可以在项目根目录下(目录下有go.mod),执行以下命令更新使用最新的框架版本:

  1. gf up -a

更进一步了解