name: Config Module

sort: 7

Parsing Configuration Files

The config module is used for parsing configuration files, inspired by database/sql. It supports ini, json, xml and yaml files. You can install it by:

  1. go get github.com/astaxie/beego/config

If you want to parse xml or yaml, you should first install:

  1. go get -u github.com/astaxie/beego/config/xml

and then import:

  1. import _ "github.com/astaxie/beego/config/xml"

Basic Usage

Initialize a parser object:

  1. iniconf, err := NewConfig("ini", "testini.conf")
  2. if err != nil {
  3.     t.Fatal(err)
  4. }

Get data from parser:

  1. iniconf.String("appname")

Parser methods

Here are the parser’s methods:

  • Setting values:
    • Set(key, val string) error
    • SaveConfigFile(filename string) error
  • Getting values:
    • String(key string) string
    • Strings(key string) []string
    • Int(key string) (int, error)
    • Int64(key string) (int64, error)
    • Bool(key string) (bool, error)
    • Float(key string) (float64, error)
    • DIY(key string) (interface{}, error)
    • GetSection(section string) (map[string]string, error)
  • Getting values or a default value:
    • DefaultString(key string, defaultval string) string
    • DefaultStrings(key string, defaultval []string) []string
    • DefaultInt(key string, defaultval int) int
    • DefaultInt64(key string, defaultval int64) int64
    • DefaultBool(key string, defaultval bool) bool
    • DefaultFloat(key string, defaultval float64) float64

Configuration sections

The ini file supports configuration sections. You can get values inside a section by using section::key.

For example:

  1. [demo]
  2. key1 = "asta"
  3. key2 = "xie"

You can use iniconf.String("demo::key2") to get the value.