以下常用方法列表，文档更新可能滞后于代码新特性，更多的方法及示例请参考代码文档：https://pkg.go.dev/github.com/gogf/gf/v2/os/gcfg

GetWithEnv

  • 说明
    • GetWithEnv方法会先从默认的配置文件中获取配置数据，获取为空的时候，将会去当前的环境变量中进行获取。需要注意的是名称命名转换规则：
    • 环境变量会将名称转换为大写，名称中的.字符转换为_字符。
    • 参数名称中会将名称转换为小写，名称中的_字符转换为.字符。

  • 格式：

    1. GetWithEnv(ctx context.Context, pattern string, def ...interface{}) (*gvar.Var, error)

  • 示例：

    1. func ExampleConfig_GetWithEnv() {
    2.     var (
    3.         key = `env.test`
    4.         ctx = gctx.New()
    5.     )
    6.     v, err := g.Cfg().GetWithEnv(ctx, key)
    7.     if err != nil {
    8.         panic(err)
    9.     }
    10.     fmt.Printf("env:%s\n", v)
    11.     if err = genv.Set(`ENV_TEST`, "gf"); err != nil {
    12.         panic(err)
    13.     }
    14.     v, err = g.Cfg().GetWithEnv(ctx, key)
    15.     if err != nil {
    16.         panic(err)
    17.     }
    18.     fmt.Printf("env:%s", v)
    20.     // Output:
    21.     // env:
    22.     // env:gf
    23. }

GetWithCmd

  • 说明：GetWithCmd方法与GetWithEnv方法类似，也是先从默认的配置对象中获取配置数据，但是获取为空的时候，是去命令行中获取配置信息。

  • 格式：

    1. GetWithCmd(ctx context.Context, pattern string, def ...interface{}) (*gvar.Var, error)

  • 示例：

    1. func ExampleConfig_GetWithCmd() {
    2.     var (
    3.         key = `cmd.test`
    4.         ctx = gctx.New()
    5.     )
    6.     v, err := g.Cfg().GetWithCmd(ctx, key)
    7.     if err != nil {
    8.         panic(err)
    9.     }
    10.     fmt.Printf("cmd:%s\n", v)
    11.     // Re-Initialize custom command arguments.
    12.     os.Args = append(os.Args, fmt.Sprintf(`--%s=yes`, key))
    13.     gcmd.Init(os.Args...)
    14.     // Retrieve the configuration and command option again.
    15.     v, err = g.Cfg().GetWithCmd(ctx, key)
    16.     if err != nil {
    17.         panic(err)
    18.     }
    19.     fmt.Printf("cmd:%s", v)
    21.     // Output:
    22.     // cmd:
    23.     // cmd:yes
    24. }

MustGetWithCmd

  • 说明：MustGetWithCmd方法与GetWithCmd方法类似，该方法只会返回配置内容，一旦内部发生任何错误，将会有panic。

  • 格式：

    1. MustGetWithCmd(ctx context.Context, pattern string, def ...interface{}) *gvar.Var

  • 示例：

    1. func ExampleConfig_MustGetWithCmd() {
    2.     var (
    3.         key = `cmd.test`
    4.         ctx = gctx.New()
    5.     )
    6.     v := g.Cfg().MustGetWithCmd(ctx, key)
    8.     fmt.Printf("cmd:%s\n", v)
    9.     // Re-Initialize custom command arguments.
    10.     os.Args = append(os.Args, fmt.Sprintf(`--%s=yes`, key))
    11.     gcmd.Init(os.Args...)
    12.     // Retrieve the configuration and command option again.
    13.     v = g.Cfg().MustGetWithCmd(ctx, key)
    15.     fmt.Printf("cmd:%s", v)
    17.     // Output:
    18.     // cmd:
    19.     // cmd:yes
    20. }

MustGetWithEnv

  • 说明：MustGetWithEnv方法与GetWithEnv方法类似，该方法只会返回配置内容，一旦内部发生任何错误，将会有panic。

  • 格式：

    1. MustGetWithEnv(ctx context.Context, pattern string, def ...interface{}) *gvar.Var

  • 示例：

    1. func ExampleConfig_MustGetWithEnv() {
    2.     var (
    3.         key = `env.test`
    4.         ctx = gctx.New()
    5.     )
    6.     v := g.Cfg().MustGetWithEnv(ctx, key)
    8.     fmt.Printf("env:%s\n", v)
    9.     if err := genv.Set(`ENV_TEST`, "gf"); err != nil {
    10.         panic(err)
    11.     }
    12.     v = g.Cfg().MustGetWithEnv(ctx, key)
    14.     fmt.Printf("env:%s", v)
    16.     // Output:
    17.     // env:
    18.     // env:gf
    19. }

Data

  • 说明：Data方法从配置对象中获取配置数据，组装成map[string]interface{}类型。

  • 格式：

    1. Data(ctx context.Context) (data map[string]interface{}, err error)

  • 示例：

    1. func ExampleConfig_Data() {
    2.     ctx = gctx.New()
    3.     content := `
    4. v1    = 1
    5. v2    = "true"
    6. v3    = "off"
    7. v4    = "1.23"
    8. array = [1,2,3]
    9. [redis]
    10.     disk  = "127.0.0.1:6379,0"
    11.     cache = "127.0.0.1:6379,1"
    12. `
    13.     c, err := gcfg.New()
    14.     if err != nil{
    15.         panic(err)
    16.     }
    17.     c.GetAdapter().(*gcfg.AdapterFile).SetContent(content)
    18.     data, err := c.Data(ctx)
    19.     if err != nil{
    20.         panic(err)
    21.     }
    23.     fmt.Println(data)
    25.     // Output:
    26.     // map[array:[1 2 3] redis:map[cache:127.0.0.1:6379,1 disk:127.0.0.1:6379,0] v1:1 v2:true v3:off v4:1.23]
    27. }

MustData

  • 说明：MustData方法从配置对象中获取配置数据，组装成map[string]interface{}类型。当该方法内部产生错误时不会返回错误，而是直接panic。

  • 格式：

    1. MustData(ctx context.Context) map[string]interface{}

  • 示例：

    1. func ExampleConfig_MustData() {
    2.     ctx = gctx.New()
    3.     content := `
    4. v1    = 1
    5. v2    = "true"
    6. v3    = "off"
    7. v4    = "1.23"
    8. array = [1,2,3]
    9. [redis]
    10.     disk  = "127.0.0.1:6379,0"
    11.     cache = "127.0.0.1:6379,1"
    12. `
    13.     c, err := gcfg.New()
    14.     if err != nil{
    15.         panic(err)
    16.     }
    18.     c.GetAdapter().(*gcfg.AdapterFile).SetContent(content)
    19.     data := c.MustData(ctx)
    21.     fmt.Println(data)
    23.     // Output:
    24.     // map[array:[1 2 3] redis:map[cache:127.0.0.1:6379,1 disk:127.0.0.1:6379,0] v1:1 v2:true v3:off v4:1.23]
    25. }

Get

  • 说明：Get方法从配置对象中获取配置数据，返回gvar泛型对象。

  • 格式：

    1. Get(ctx context.Context, pattern string, def ...interface{}) (*gvar.Var, error)

  • 示例：

    1. func ExampleConfig_Get() {
    2.     ctx = gctx.New()
    3.     content := `
    4. v1    = 1
    5. v2    = "true"
    6. v3    = "off"
    7. v4    = "1.23"
    8. array = [1,2,3]
    9. [redis]
    10.     disk  = "127.0.0.1:6379,0"
    11.     cache = "127.0.0.1:6379,1"
    12. `
    13.     c, err := gcfg.New()
    14.     if err != nil{
    15.         panic(err)
    16.     }
    18.     c.GetAdapter().(*gcfg.AdapterFile).SetContent(content)
    19.     data,err := c.Get(ctx,"redis")
    21.     if err != nil {
    22.         panic(err)
    23.     }
    24.     fmt.Println(data)
    26.     // Output:
    27.     // {"cache":"127.0.0.1:6379,1","disk":"127.0.0.1:6379,0"}
    28. }

MustGet

  • 说明：MustGet方法与Get类似，也是配置对象中获取配置数据，组装成gvar结构，但是返回参数只有一个：*gvar.Var
  • 注意：当配置文件不存在或者是其他error的情况下，会直接panic，需要做好异常捕获措施。

  • 格式：

    1. MustGet(ctx context.Context, pattern string, def ...interface{}) *gvar.Var

  • 示例：

    1. func ExampleConfig_MustGet() {
    2.     ctx = gctx.New()
    3.     content := `
    4. v1    = 1
    5. v2    = "true"
    6. v3    = "off"
    7. v4    = "1.23"
    8. array = [1,2,3]
    9. [redis]
    10.     disk  = "127.0.0.1:6379,0"
    11.     cache = "127.0.0.1:6379,1"
    12. `
    13.     c, err := gcfg.New()
    14.     if err != nil{
    15.         panic(err)
    16.     }
    18.     c.GetAdapter().(*gcfg.AdapterFile).SetContent(content)
    19.     data := c.MustGet(ctx,"redis")
    21.     fmt.Println(data)
    23.     // Output:
    24.     // {"cache":"127.0.0.1:6379,1","disk":"127.0.0.1:6379,0"}
    25. }

GetAdapter

  • 说明：GetAdapter方法是获取当前运行的gcfg适配器信息，关于适配器相关，可以请点击配置管理-接口化设计

  • 格式：

    1. GetAdapter() Adapter

  • 示例：

    1. func ExampleConfig_GetAdapter() {
    2.     c, err := gcfg.New()
    3.     if err != nil{
    4.         panic(err)
    5.     }
    7.     adapter := c.GetAdapter()
    8.     fmt.Println(adapter)
    10.     // Output:
    11.     // &{config.toml 0xc00014d720 0xc000371880 false}
    12. }

SetAdapter

  • 说明：SetAdapter方法是设置当前运行的gcfg适配器信息，关于适配器相关，可以请点击配置管理-接口化设计

  • 格式：

    1.  SetAdapter(adapter Adapter)

  • 示例：

    1. func ExampleConfig_SetAdapter() {
    2.     c, err := gcfg.New()
    3.     if err != nil{
    4.         panic(err)
    5.     }
    7.     adapter := c.GetAdapter()
    8.     c.SetAdapter(adapter)
    9.     fmt.Println(adapter)
    11.     // Output:
    12.     // &{config.toml 0xc00014d720 0xc000371880 false}
    13. }