go配置解析库 - viper

本文涉及的产品
云数据库 RDS SQL Server,独享型 2核4GB
云数据库 RDS MySQL Serverless,0.5-2RCU 50GB
简介: go配置解析库 - viper

简介

viper 是一个配置解决方案,拥有丰富的特性:

  • 支持 JSON/TOML/YAML/HCL/envfile/Java properties 等多种格式的配置文件;
  • 可以设置监听配置文件的修改,修改时自动加载新的配置;
  • 从环境变量、命令行选项和io.Reader中读取配置;
  • 从远程配置系统中读取和监听修改,如 etcd/Consul;
  • 代码逻辑中显示设置键值。

获取

$ go get github.com/spf13/viper

读取配置

viper读入配置有如下读入方式:

  • 设置默认的配置名
  • 读取配置文件
  • 监听和重新读取配置文件
  • 从io.Reader读取配置
  • 从环境变量读取
  • 从命令行标志读取
  • 从远程Key/Value存储读取

    读取顺序

  1. 从默认的设置中读取
  2. 从pflag中读取
  3. 从环境变量中读取
  4. 从配置文件中读取
  5. 从KV存储中读取
  6. 从默认的配置文件中读取

    其API如下,这里我将其进行分组

在这里插入图片描述

AddConfigPath

func AddConfigPath(in string)

添加文件的搜索路径

AddRemoteProvider

func AddRemoteProvider(provider, endpoint, path string) error

添加远程源,当前支持etcd、consul、firestore

  • provider:etcd、consul、firestore
  • endpoint:连接地址
  • path从kv存储中检索配置的路径,例如要从/configs/myapp.json检索名为myapp.json的配置文件则应该设置为/config并将配置名(SetConfigName)设置为myapp

AddSecureRemoteProvider

func AddSecureRemoteProvider(provider, endpoint, path, secretkeyring string) error

添加远程源,当前支持etcd、consul、firestore

  • provider:etcd、consul、firestore
  • endpoint:连接地址
  • path从kv存储中检索配置的路径,例如要从/configs/myapp.json检索名为myapp.json的配置文件则应该设置为/config并将配置名(SetConfigName)设置为myapp
  • secretkeyring:密钥路径

AllKeys

func AllKeys() []string

返回所有的键。

AllSettings

func AllSettings() map[string]interface{
   
   }

将所有键值对返回

AllowEmptyEnv

func AllowEmptyEnv(allowEmptyEnv bool)

是否允许空的环境变量视为有效值,默认是false

AutomaticEnv

func AutomaticEnv()

开启环境变量检查是否匹配现有键值,如果匹配则加载。

BindEnv

func BindEnv(input ...string) error

将环境变量的值设置到viper键中,该函数可以提供一或两个参数。

  • 只提供一个参数: 默认环境变量与该简直名称相同。
  • 提供两个参数:第一个参数是键,第二个参数是环境变量名称。

例如:

//假设配置文件中设置了值为192.168.3.244
fmt.Println(viper.GetString("mysql.ip")) // 192.168.3.244
// 绑定环境变量,假设我们设置mysql.ip=127.0.0.1、MYSQL.IP=localhost
viper.BindEnv("mysql.ip")//127.0.0.1是调用os.LookupEnv获取的值
fmt.Println(viper.GetString("mysql.ip"))

BindFlagValue

func BindFlagValue(key string, flag FlagValue) error

将键同flag绑定

BindFlagValues

func BindFlagValues(flags FlagValueSet) error

绑定flag集合

BindPFlag

func BindPFlag(key string, flag *pflag.Flag) error

绑定pflag

BindPFlags

func BindPFlags(flags *pflag.FlagSet) error

绑定pflag集合

ConfigFileUsed

func ConfigFileUsed() string

返回正在使用的配置文件,例如:

D:\workspace\myOpenSource\go-example\viper\ini\config.ini

Debug

func Debug()

打印调试信息,会根据viper查找顺序打印配置信息。例如:

Aliases:
map[string]string{
   
   }
Override:
map[string]interface {
   
   }{
   
   }
PFlags:
map[string]viper.FlagValue{
   
   }
Env:
map[string][]string{
   
   }
Key/Value Store:
map[string]interface {
   
   }{
   
   }
Config:
map[string]interface {
   
   }{
   
   "mysql.database":"awesome", "mysql.ip":"127.0.0.1", "mysql.password":"123456", "mysql.port":"3306", "mysql.user":"dj", "redis.ip":"127.0.0.1", "redis.port":"7381"}
Defaults:
map[string]interface {
   
   }{
   
   }

Get

获取指定key值信息

func Get(key string) interface{
   
   }
func GetBool(key string) bool
func GetDuration(key string) time.Duration
func GetFloat64(key string) float64
func GetInt(key string) int
func GetInt32(key string) int32
func GetInt64(key string) int64
func GetIntSlice(key string) []int
func GetSizeInBytes(key string) uint
func GetString(key string) string
func GetStringMap(key string) map[string]interface{
   
   }
func GetStringMapString(key string) map[string]string
func GetStringMapStringSlice(key string) map[string][]string
func GetStringSlice(key string) []string
func GetTime(key string) time.Time
func GetUint(key string) uint
func GetUint32(key string) uint32
func GetUint64(key string) uint64

InConfig

func InConfig(key string) bool

判断这个键是否存在。

fmt.Println(viper.InConfig("mysql"))    //false
fmt.Println(viper.InConfig("ip"))       //false
fmt.Println(viper.InConfig("mysql.ip")) //true

InSet

func IsSet(key string) bool

判断键是否是个集合

MergeConfig

func MergeConfig(in io.Reader) error
func MergeConfigMap(cfg map[string]interface{
   
   }) error
func MergeInConfig() error

会将新的配置和原有的配置合并

OnConfigChang

func OnConfigChange(run func(in fsnotify.Event))

设置配置改变时的回调函数

ReadConfig

func ReadConfig(in io.Reader) error

从IO接口中读取配置

ReadInConfig

func ReadInConfig() error

加载配置文件

ReadRemoteConfig

func ReadRemoteConfig() error

加载远程配置文件

RegisterAlias

func RegisterAlias(alias string, key string)

为key设置一个别名。

Reset

func Reset()

将存储的所有信息清空,仅用于测试

SafeWriteConfig

func SafeWriteConfig() error

仅当文件不存在时,将当前配置写入文件

SafeWriteConfigAs

func SafeWriteConfigAs(filename string) error

将当前配置写入给定文件名(如果它不存在)。

Set

func Set(key string, value interface{
   
   })

覆盖内存中的键的值,对键不区分大小写。将用于代替通过flag、配置文件、环境变量、默认值或键/值存储获得的值。

SetConfigFile

func SetConfigFile(in string)

明确定义配置文件的路径、名称和扩展名。Viper 将使用它而不检查任何配置路径。

SetConfigName

func SetConfigName(in string)

设置配置文件的名称。不包括扩展名。

SetConfigPermissions

func SetConfigPermissions(perm os.FileMode)

设置给定配置文件的权限

SetConfigType

func SetConfigType(in string)

设置配置文件的类型,如json、ini、toml

SetDefault

func SetDefault(key string, value interface{
   
   })

为指定的键设置默认值,对key不区分大小写,仅当用户没有通过flag、配置文件以及环境变量设置值时才使用默认值。

SetEnvKeyReplacer

func SetEnvKeyReplacer(r *strings.Replacer)

允许你使用一个strings.Replacer对象来将配置名重写为Env名。如果你想在Get()中使用包含-的配置名 ,但希望对应的环境变量名包含_分隔符,就可以使用该方法。使用它的一个例子可以在项目中viper_test.go文件里找到。

func TestSetEnvKeyReplacer(t *testing.T) {
   
   
    Reset()

    AutomaticEnv()

    testutil.Setenv(t, "REFRESH_INTERVAL", "30s")

    replacer := strings.NewReplacer("-", "_")
    SetEnvKeyReplacer(replacer)

    assert.Equal(t, "30s", Get("refresh-interval"))
}

SetEnvPrefix

func SetEnvPrefix(in string)

定义环境变量使用的前缀。

SetEnvPrefix("spf") // 将会自动转为大写
BindEnv("id")

os.Setenv("SPF_ID", "13") // 通常通过系统环境变量来设置

id := Get("id") // 13

SetFs

func SetFs(fs afero.Fs)

设置文件系统。github.com/spf13/afero

SetTypeByDefaultValue

func SetTypeByDefaultValue(enable bool)

使用 Get 函数时基于键的默认值而不是基于正常获取逻辑返回的值启用或禁用键值类型的推断。
例如,如果一个键的默认值为 []string{},并且通过环境变量将相同的键设置为“ab c”,则调用 Get 函数将返回该键的字符串切片,如果该键的类型由默认值推断,Get 函数将返回:

[]string {
   
   "a", "b", "c"}

否则返回

"a b c"

Unmarshal

func Unmarshal(rawVal interface{
   
   }, opts ...DecoderConfigOption) error

将配置解组到 Struct。确保正确设置结构字段上的标签。

UnmarshalExact

func UnmarshalExact(rawVal interface{
   
   }, opts ...DecoderConfigOption) error

UnmarshalExact 将配置解组为 Struct,如果目标结构中不存在字段,则会出错。

UnmarshalKey

func UnmarshalKey(key string, rawVal interface{
   
   }, opts ...DecoderConfigOption) error

UnmarshalKey 采用单个键并将其解组为 Struct。

WatchConfig

func WatchConfig()

监控配置

WatchRemoteConfig

func WatchRemoteConfig() error

WriteConfig

func WriteConfig() error

WriteConfigAs

func WriteConfigAs(filename string) error

WriteConfigAs 将当前配置写入给定的文件名。

相关文章
|
21天前
|
测试技术 Go 开发者
go-carbon v2.3.8 发布,轻量级、语义化、对开发者友好的 golang 时间处理库
carbon 是一个轻量级、语义化、对开发者友好的 golang 时间处理库,支持链式调用。
16 0
|
1天前
|
设计模式 测试技术 Go
Go 项目必备:Wire 依赖注入工具的深度解析与实战应用
在现代软件开发中,依赖注入(Dependency Injection,简称 DI)已经成为一种广泛采用的设计模式。它的核心思想是通过外部定义的方式,将组件之间的依赖关系解耦,从而提高代码的可维护性、可扩展性和可测试性。然而,随着项目规模的增长,手动管理复杂的依赖关系变得日益困难。这时,依赖注入代码生成工具就显得尤为重要。在众多工具中,Wire 以其简洁、强大和易用性脱颖而出,成为 Go 语言项目中的宠儿。本文将带你深入了解 Wire 的安装、基本使用、核心概念以及高级用法,并通过一个实际的 web 博客项目示例,展示如何利用 Wire 简化依赖注入的实现。准备好了吗?让我们开始这场代码解耦的奇
|
1天前
|
存储 安全 Java
Go Slice的底层实现原理深度解析
在Go语言的世界里,切片(Slice)是一种极其重要的数据结构,它以其灵活性和高效性在众多编程场景中扮演着核心角色。本文将深入探讨Go切片的底层实现原理,通过实例和源码分析,带你领略Go语言设计之美。
|
3天前
|
Go 开发者 索引
Go语言中的循环控制结构解析
【2月更文挑战第2天】本文将详细探讨Go语言中的循环控制结构,包括`for`循环、`range`循环以及`无限循环`的使用方法和适用场景。通过掌握这些循环结构,Go语言开发者能够更加高效地进行迭代操作、处理集合数据以及实现复杂的控制逻辑。
|
3天前
|
程序员 调度 数据库
Python中的异步编程:asyncio库和协程的深入解析
Python中的异步编程:asyncio库和协程的深入解析
|
4天前
|
存储 Prometheus 监控
性能监控之国产时序库TDengine TDinsight dashboard 指标解析
【2月更文挑战第1天】性能监控之国产时序库TDengine TDinsight dashboard 指标解析
134 1
性能监控之国产时序库TDengine TDinsight dashboard 指标解析
|
6天前
|
Go 索引
Go 1.22 slices 库的更新:高效拼接、零化处理和越界插入优化
本文详细介绍了 Go 1.22 版本中 slices 库的更新内容,总结起来有三个方面:新增了 Concat 函数、对部分函数新增了零化处理的逻辑和对 Insert 函数进行了越界插入优化
44 1
Go 1.22 slices 库的更新:高效拼接、零化处理和越界插入优化
|
12天前
|
域名解析 网络协议 应用服务中间件
云解析DNS问题之配置域名解析ip地址如何解决
DNS解析是指将人类可读的域名转换成机器可读的IP地址的过程,它是互联网访问中不可或缺的一环;本合集将介绍DNS解析的机制、类型和相关问题的解决策略,以确保域名解析的准确性和高效性。
18 1
|
16天前
|
数据采集 文字识别 Linux
Python爬虫解析库安装#1
摘要:python解析库 lxml安装、beautiful soup 安装、pyquery安装、tesserocr安装【2月更文挑战第3天】
47 3
Python爬虫解析库安装#1
|
24天前
|
域名解析 应用服务中间件 Linux
【服务器】使用域名解析服务器的IP地址并配置SSL证书
【服务器】使用域名解析服务器的IP地址并配置SSL证书
203 0

相关产品

  • 云迁移中心
  • 推荐镜像

    更多