gf的配置管理由gcfg模块实现，gcfg模块是并发安全的，仅提供配置文件读取功能，不提供数据写入/修改功能，支持的数据文件格式包括： JSON、XML、YAML/YML、TOML，项目中开发者可以灵活地选择自己熟悉的配置文件格式来进行配置管理。如果想要支持对数据文件的读取及修改，并且可以进行数据格式转换，请参看 gparser包。

使用方式：

import "github.com/gogf/gf/g/os/gcfg"

接口文档：

https://godoc.org/github.com/gogf/gf/g/os/gcfg

配置管理

配置文件

默认读取的配置文件为config.toml，toml类型文件也是默认的、推荐的配置文件格式，如果想要自定义文件格式，可以通过SetFileName方法修改默认读取的配置文件名称（如：config.json, cfg.yaml, cfg.xml等等）。

例如，我们可以通过以下两种方式读取config.json配置文件中的数据库配置database。

// 设置默认配置文件，默认的 config.toml 将会被覆盖
g.Config().SetFileName("config.json")
// 后续读取时将会读取到 config.json 配置文件内容，
g.Config().Get("database")

我们有两种方式进行配置文件的管理，使用全局的g.Config()获取单例对象（推荐），或者单独使用gcfg模块进行管理。

示例配置文件 config.toml：

# 模板引擎目录
viewpath = "/home/www/templates/"
# MySQL数据库配置
[database]
    [[database.default]]
        host     = "127.0.0.1"
        port     = "3306"
        user     = "root"
        pass     = "123456"
        name     = "test1"
        type     = "mysql"
        role     = "master"
        charset  = "utf8"
        priority = "1"
    [[database.default]]
        host     = "127.0.0.1"
        port     = "3306"
        user     = "root"
        pass     = "123456"
        name     = "test2"
        type     = "mysql"
        role     = "master"
        charset  = "utf8"
        priority = "1"
# Redis数据库配置
[redis]
    disk  = "127.0.0.1:6379,0"
    cache = "127.0.0.1:6379,1"

注意：以上toml配置文件中的密码字段值123456使用了双引号进行包含，用以标识该密码字段为字符串类型，防止配置文件读取时自动转换为整型引起歧义。

配置内容

gcfg包也支持直接内容配置，而不是读取配置文件，通过以下包配置方法实现全局的配置：

func SetContent(content string, file ...string)
func GetContent(file ...string) string
func RemoveConfig(file ...string)
func ClearContent()

需要注意的是该配置是全局生效的，并且优先级会高于读取配置文件。因此，假如我们通过gcfg.SetContent("v = 1", "config.toml")配置了config.toml的配置内容，并且也同时存在config.toml配置文件，那么只会使用到SetContent的配置内容，而配置文件内容将会被忽略。

配置读取

gcfg包最大的特点是支持按层级获取配置数据，层级访问默认通过英文”.“号指定，其中pattern参数和【gjson包】的pattern参数一致。

例如针对以上config.toml配置文件内容的层级读取：

// /home/www/templates/
g.Config().Get("viewpath")
// 127.0.0.1:6379,1
g.Config().Get("redis.cache")
// test2
g.Config().Get("database.default.1.name")

配置目录

目录配置方法

gcfg配置管理器支持非常灵活的多目录自动搜索功能，通过SetPath可以修改目录管理目录为唯一的一个目录地址，同时，我们推荐通过AddPath方法添加多个搜索目录，配置管理器底层将会按照添加目录的顺序作为优先级进行自动检索。直到检索到一个匹配的文件路径为止，如果在所有搜索目录下查找不到配置文件，那么会返回失败。

默认目录配置

gcfg配置管理对象初始化时，默认会自动添加以下配置文件搜索目录：

1. 当前工作目录及其下的config目录：例如当前的工作目录为/home/www时，将会添加/home/www及/home/www/config；
2. 当前可执行文件所在目录及其下的config目录：例如二进制文件所在目录为/tmp时，将会添加/tmp及/tmp/config；
3. 当前main源代码包所在目录及其下的config目录(仅对源码开发环境有效)：例如main包所在目录为/home/john/workspace/gf-app时，将会添加/home/john/workspace/gf-app及/home/john/workspace/gf-app/config；

默认目录修改

我们可以通过以下方式修改配置管理器的配置文件搜索目录，配置管理对象将会只在该指定目录执行配置文件检索：

1. 通过配置管理器的SetPath方法手动修改；
2. 修改命令行启动参数 - gf.gcfg.path；
3. 修改指定的环境变量 - GF_GCFG_PATH；

假如我们的执行程序文件为main，那么可以通过以下方式修改配置管理器的配置文件目录(Linux下)：

1. (推荐)通过单例模式

    g.Config().SetPath("/opt/config")

2. 通过命令行启动参数

    ./main --gf.gcfg.path=/opt/config/

3. 通过环境变量（常用在容器中）
   • 启动时修改环境变量：

       GF_GCFG_PATH=/opt/config/; ./main

   • 使用genv模块来修改环境变量：

       genv.Set("GF_GCFG_PATH", "/opt/config")

单例管理

gcfg集成到了gf框架的单例管理器中，可以方便地通过g.Config()获取默认的全局配置管理对象。同时，我们也可以通过gcfg.Instance包方法获取配置管理对象单例。

使用g.Config

我们来看一个示例，演示如何读取全局配置的信息。需要注意的是，全局配置是与框架相关的，因此统一使用g.Config()进行获取。以下是一个默认的全局配置文件，包含了模板引擎的目录配置以及MySQL数据库集群(两台master)的配置。

package main
import (
    "fmt"
    "github.com/gogf/gf/g"
)
func main() {
    fmt.Println(g.Config().GetString("viewpath"))
    fmt.Println(g.Config().GetString("database.default.0.host"))
}

以上示例为读取数据库的第一个配置的host信息。运行后输出：

/home/www/templates/
127.0.0.1

可以看到，我们可以通过g.Config()方法获取一个全局的配置管理器单例对象。配置文件内容可以通过英文“.”号进行层级访问（数组默认从0开始），pattern参数database.default.0.host表示读取database配置项中default数据库集群中的第0项数据库服务器的host数据。

使用gcfg.Instance

当然也可以独立使用gcfg包，通过Instance方法获取单例对象。

package main
import (
    "fmt"
    "github.com/gogf/gf/g/os/gcfg"
)
func main() {
    fmt.Println(gcfg.Instance().GetString("viewpath"))
    fmt.Println(gcfg.Instance().GetString("database.default.0.host"))
}

自动检测更新

配置管理器使用了缓存机制，当配置文件第一次被读取后会被缓存到内存中，下一次读取时将会直接从缓存中获取，以提高性能。同时，配置管理器提供了对配置文件的自动检测更新机制，当配置文件在外部被修改后，配置管理器能够即时地刷新配置文件的缓存内容。

配置管理器的自动检测更新机制是gf框架特有的一大特色。