一架梯子，一头程序猿，仰望星空！

Beego快速入门教程

下一页 ❯

beego 是一个快速开发 Go 应用的 HTTP 框架，可以用来快速开发 API、Web 及后端服务等各种应用，是一个 RESTful 的框架，相对于echo框架仅包含路由和控制器核心模块，beego是一个完整的MVC框架包括路由&控制器、model 数据库ORM封装、view模板处理。

下面一步步的介绍如何快速开始一个项目。

1.beego的流程设计

 流程图说明：

  1. http请求从左侧main入口函数开始进入框架
  2. UrL路由解析然后确定执行那个控制器(controller)
  3. 执行请求前的过滤器 （过滤器一般用来拦截请求，例如做api签名校验，session处理，安全验证等等）
  4. 执行控制器 （控制器根据需要调用model，session, 日志等模块）
  5. 执行请求后的过滤器
  6. 视图输出返回给用户

2.安装包

安装beego核心包

go get -u github.com/beego/beego/v2

安装orm包用于操作数据库，beego的orm包是独立的模块需要单独安装

go get github.com/beego/beego/v2/client/orm

安装mysql驱动, 必须安装mysql驱动,orm包才能工作

go get github.com/go-sql-driver/mysql

安装bee工具包，这个是beego开发的辅助工具，用于快速创建项目，运行项目以及打包项目

go get -u github.com/beego/bee/v2

提示：安装bee包后，需要将$GOPATH/bin路径添加到环境变量path中, 否则会提示找不到bee命令，$GOPATH代表的就是你的GOPATH路径，如果你不知道GOPATH路径在哪里，执行下go env命令，会列出所有go相关的环境变量，从里面找到GOPATH路径。

3.使用bee创建项目

下面使用bee快速创建一个新的项目, 打开命令窗口，进入$GOPATH/src目录，然后执行bee命令。

bee new tizi365

bee工具在当前目录创建了一个tizi365的目录，里面包含了beego项目的基本结构。

提示: 如果你熟悉beego项目结构也可以手动创建项目，当然为了效率还是建议用bee快速创建。

4.项目结构

下面介绍下项目结构

tizi365
├── conf            - 配置文件存放目录
│   └── app.conf    - beego应用配置文件，里面包含一些默认的配置包括启动端口、运行模式等等
├── controllers     - 控制器目录
│   └── default.go
├── main.go         - 入口文件
├── models          - model目录，存放我们的业务逻辑和数据库相关的操作
├── routers         - 路由配置目录，主要存放我们各个业务模块的路由设置
│   └── router.go
├── static          - 静态资源目录，默认静态资源访问url为 "http://域名/static/资源路径"
│   ├── css
│   ├── img
│   └── js
├── tests           - 单元测试脚本目录
│   └── default_test.go
└── views           - 视图模板目录
    └── index.tpl

5.运行项目

前面已经创建了项目，现在可以把项目运行起来看看效果.

通过bee工具运行项目, 首先在命令创建进入 "项目根目录"。

bee run

提示：bee运行项目，支持热编译，就是如果你修改了go文件，bee会自动重新编译，你只要刷新页面就可以看到最新的效果，不需要手动编译。

然后通过浏览器访问: http://localhost:8080 , 可以看到如下效果：

提示：你也可以直接运行main.go文件， 例如： go run main.go，这种方式每次修改文件，需要手动编译。

6.控制器逻辑

我们看下beego控制器怎么写？
文件: tizi365/controllers/default.go

package controllers

import (
	beego "github.com/beego/beego/v2/server/web"
)

// 定义一个控制器结构体
// 我们一般一个模块定义一个控制器
type MainController struct {
    // 嵌套beego基础控制器，在go语言中嵌套struct，就类似继承的概念。
    // 这里就相当于，继承了beego.Controller的方法和属性。
	beego.Controller 
}

// 覆盖beego.Controller的Get方法，用于处理RESTful请求中的get请求
// beego.Controller默认支持多种RESTful方法，例如：Post、Put、Delete等等
func (c *MainController) Get() {
    // Data是继承过来的属性，是map类型，可以保存任意类型数据，主要用于保存请求响应数据
    // 我们可以通过Data将参数，传入视图模板文件。
	// 这里设置了两个参数
	c.Data["Website"] = "tizi365.com"
	c.Data["Email"] = "tizi365@demo.com"
	
	// 设置需要渲染的模板文件，框架会去views目录查找这个模板文件
	c.TplName = "index.tpl"
}

7.设置Url路由

下面看看怎么设置路由。

package routers

import (
	"tizi365/controllers"
	beego "github.com/beego/beego/v2/server/web"
)

// go 包初始化函数，go语言中在导入一个包的时候，如果被导入包存在init函数，会执行init函数
// 因此这里可以使用init函数初始化路由设置
func init() {
    // 使用beego.Router函数，注册路由规则。
    // 第一个参数是url路由，第二个参数是控制器
    // 这里的意思就是将访问 / 这个url的请求，交给controllers.MainController控制器处理。
    beego.Router("/", &controllers.MainController{})
}

如果我们增加下面路由设置:

beego.Router("/tizi365", &controllers.MainController{})

访问:http://localhost:8080/tizi365 和 http://localhost:8080/ 得到的结果一样，因为这两个url地址都是由同一个控制器处理。

路由规则说明：
大家可能发现上面的路由注册规则，只是定义了，那个url由那个控制器执行，但是没有说明url请求由控制器的那个函数执行， 一个控制器可以包含多个函数;

beego RESTful路由规则，默认是通过 请求方法 确认由那个控制器方法执行，例如get请求，由Get方法执行，POST请求由Post方法执行。

8.编写model逻辑

这里我们看一个mysql数据库操作的例子。

8.1.定义表结构:

CREATE TABLE `users` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT COMMENT '自增ID',
  `username` varchar(30) NOT NULL COMMENT '账号',
  `password` varchar(100) NOT NULL COMMENT '密码',
   PRIMARY KEY (`id`)
  ) ENGINE=InnoDB DEFAULT CHARSET=utf8

大家可以使用自己熟悉的工具将mysql表创建好。

8.2.初始化数据库连接

一般初始化数据库连接都是在main.go入口的地方设置一次就行，下面看下main.go文件改成什么样了。

package main

import (
	beego "github.com/beego/beego/v2/server/web"
	"github.com/beego/beego/v2/client/orm"
	_ "tizi365/routers"
	//导入mysql驱动，这是必须的
	_ "github.com/go-sql-driver/mysql"
)

//初始化应用设置， 我们通过init函数初始化数据库连接，go语言中这个函数会优先执行
func init() {
    // 这里注册一个default默认数据库，数据库驱动是mysql.
    // 第三个参数是数据库dsn, 配置数据库的账号密码，数据库名等参数
    //  dsn参数说明：
    //      username    - mysql账号
    //      password    - mysql密码
    //      db_name     - 数据库名
    //      127.0.0.1:3306 - 数据库的地址和端口
	orm.RegisterDataBase("default", "mysql", "username:password@tcp(127.0.0.1:3306)/db_name?charset=utf8")
}

func main() {
	beego.Run()
}

为了初始化mysql连接，在入口main.go文件，增加init函数初始化数据库设置。

8.3.创建model

然后创建一个user model, 文件路径：tizi365/models/user.go , 代码如下

package models

import (
	"github.com/beego/beego/v2/client/orm"
)

// 定义User模型，绑定users表结构, 其实就是用来保存sql查询结果。
type User struct {
	Id int
	Username string
	Password string
}

// 定义User 模型绑定那个表？
func (u *User) TableName() string {
    // 返回mysql表名
	return "users"
}

//初始化函数，可以用来向orm注册model
func init() {
    // 向orm注册user模型
	orm.RegisterModel(&User{})
}

// 根据id查询用户信息
func GetUserById(id int) *User {
	if  id == 0 {
		return  nil
	}
    
    // 创建orm对象, 后面都是通过orm对象操作数据库
	o := orm.NewOrm()
	
	// 初始化一个User模型对象
	user := User{}
	// 设置查询参数
	user.Id = id
	
	// 调用Read方法，根据user设置的参数，查询一条记录，结果保存到user结构体变量中
	// 默认是根据主键进行查询
	// 等价sql： SELECT `id`, `username`, `password` FROM `users` WHERE `id` = 1
	err := o.Read(&user)
	
	// 检测查询结果，
	if err == orm.ErrNoRows {
		// 找不到记录
		return nil
	} else if err == orm.ErrMissPK {
		// 找不到住建
		return nil
	}
	
	return &user
}

提示： 具体的orm用法，后续教程有详细说明，这里大概了解下大概的用法。

8.4.通过控制器调用model

下面修改控制器代码
文件: tizi365/controllers/default.go

func (c *MainController) Get() {
	c.Data["Website"] = "tizi365.com"
	c.Data["Email"] = "tizi365@demo.com"
	
	// 调用model，查询用户id为1 的用户信息
    user := models.GetUserById(1)
	
	// 然后将user数据保存到Data中, 将参数传给后面的views视图模板处理
	c.Data["user"] = user
	
	// 使用新的视图模板user.tpl
	c.TplName = "user.tpl"
}

9.编写view视图逻辑

这里编写一个新的视图模板, 代码如下:
文件: tizi365/views/user.tpl

<!DOCTYPE html>
<html lang="zh-CN">
<head>
	<title>Demo</title>
	<meta charset="utf-8">
</head>
<body>
<h1>网站: {{.Website}}</h1>
{{ if .user }}
用户名: {{.user.Username}}
{{else}}
查找不到用户
{{ end }}
</body>
</html>

访问url: http://localhost:8080, 如果查询的用户存在，则显示用户名，否则显示查找不到用户。

提示: beego使用的是go自带的模板引擎，如果暂时看不懂，大家可以先忽略具体的模板语法，后续的教程会有讲解。

10.项目打包

项目完成后需要将代码打包发布到线上，这里依然推荐使用bee工具打包，bee工具可以一键将项目需要的相关文件一起打包成一个压缩包，只需要到线上解压即可。

下面是bee打包的例子， 首先将命令窗口的目录切换到 "项目根目录", 然后执行下面命令

bee pack

打包成功后再项目根目录下生成一个tizi365.tar.gz的压缩包，命名格式: ${项目名}.tar.gz

我们可以解压缩，看看压缩包包含什么内容：

tizi365.tar.gz
├── conf            - 配置文件存放目录,这里包含我们的配置文件
├── static          - 静态资源目录，包含我们静态资源文件
├── views           - 视图模板目录，包含模板文件
└── tizi365         - 这个就是我们的项目打包后的可执行程序，按我们项目命名

注意: 线上服务器一般都是linux环境，所以建议在linux环境打包项目，不要在windows环境打包，否则打包生成的可执行程序是.exe格式的，linux无法运行。

如果你不嫌麻烦，依然可以手动编译项目，然后将相关文件打包到一块。

下一页 ❯