GFast 开源项目教程

1. 项目的目录结构及介绍

GFast 项目的目录结构如下：

gfast/
├── api
│   ├── admin
│   └── open
├── app
│   ├── controller
│   ├── model
│   ├── service
│   └── task
├── boot
├── config
├── doc
├── library
├── middleware
├── public
├── router
├── template
├── Dockerfile
├── go.mod
├── go.sum
└── main.go

目录结构介绍

• api: 包含前后端接口文件。
  • admin: 后台管理接口。
  • open: 开放接口。
• app: 应用核心代码。
  • controller: 控制器层，处理业务逻辑。
  • model: 数据模型层，定义数据结构和数据库操作。
  • service: 服务层，处理复杂的业务逻辑。
  • task: 任务调度相关代码。
• boot: 启动相关配置和初始化代码。
• config: 配置文件目录。
• doc: 项目文档。
• library: 公共库，包含一些通用的工具函数。
• middleware: 中间件，处理请求和响应的中间逻辑。
• public: 静态资源文件，如图片、CSS、JS 等。
• router: 路由配置文件。
• template: 模板文件，用于前端渲染。
• Dockerfile: Docker 配置文件，用于容器化部署。
• go.mod 和 go.sum: Go 模块依赖管理文件。
• main.go: 项目入口文件。

2. 项目的启动文件介绍

项目的启动文件是 main.go，它是整个项目的入口点。以下是 main.go 的主要内容：

package main

import (
    "gfast/boot"
    "gfast/config"
    "gfast/router"
    "github.com/gogf/gf/frame/g"
    "github.com/gogf/gf/net/ghttp"
)

func main() {
    // 初始化配置
    config.Init()

    // 启动服务
    s := g.Server()
    s.SetPort(8080)
    s.AddStaticPath("/static", "public")
    router.InitRouter(s)
    s.Run()
}

启动文件介绍

• 导入依赖: 导入了项目所需的包，包括 gfast 项目内部的包和外部依赖包。
• 初始化配置: 调用 config.Init() 方法初始化项目配置。
• 启动服务: 创建一个 ghttp.Server 实例，设置端口为 8080，添加静态资源路径，并调用 router.InitRouter(s) 初始化路由，最后启动服务器。

3. 项目的配置文件介绍

项目的配置文件位于 config 目录下，主要包括以下文件：

config/
├── config.toml
├── database.toml
└── log.toml

配置文件介绍

• config.toml: 主配置文件，包含应用的基本配置，如端口、日志级别等。
• database.toml: 数据库配置文件，包含数据库连接信息，如数据库类型、地址、用户名、密码等。
• log.toml: 日志配置文件，包含日志输出级别、输出路径等配置。

示例配置

config.toml

[server]
Address = ":8080"
ReadTimeout = 60
WriteTimeout = 60

database.toml

[database]
Type = "mysql"
User = "root"
Password = "123456"
Host = "127.0.0.1"
Port = 3306
Name = "gfast"

log.toml

[log]
Level = "info"
Path = "./logs"

以上是 GFast 开源项目的目录结构、启动文件和配置文件的详细介绍。希望这份教程能帮助你更好地理解和使用 GFast 项目。