使用onion库解析多层加密配置

onion是一个Go语言配置管理库，支持多层配置源、配置热加载和加密配置等功能。下面我将详细介绍如何使用onion库。

基本安装

首先安装onion库：

go get github.com/goraz/onion

基本使用示例

package main

import (
	"fmt"
	"github.com/goraz/onion"
	"log"
)

func main() {
	// 创建配置层
	o := onion.New()
	
	// 添加环境变量层
	o.AddLayer(onion.NewEnvLayer("APP_", true))
	
	// 添加JSON文件层
	o.AddLayer(onion.NewFileLayer("./config.json"))
	
	// 获取配置值
	port := o.GetIntDefault("server.port", 8080)
	debug := o.GetBoolDefault("debug", false)
	
	fmt.Printf("Server will start on port %d, debug mode: %v\n", port, debug)
}

多层配置支持

onion支持多种配置源，可以按优先级叠加：

o := onion.New()

// 1. 默认值层 (最低优先级)
defaults := map[string]interface{}{
	"server.port": 8080,
	"debug":       false,
}
o.AddLayer(onion.NewMapLayer(defaults))

// 2. 配置文件层 (JSON/YAML)
o.AddLayer(onion.NewFileLayer("./config.json"))

// 3. 环境变量层 (较高优先级)
o.AddLayer(onion.NewEnvLayer("APP_", true))

// 4. 命令行参数层 (最高优先级)
o.AddLayer(onion.NewFlagLayer(flag.CommandLine))

加密配置支持

onion支持加密的配置值，使用crypto子包：

import "github.com/goraz/onion/crypto"

func main() {
	o := onion.New()
	
	// 添加加密层
	enc := crypto.NewAES([]byte("16-or-32-byte-key-here"))
	o.AddLayer(crypto.NewLayer(enc))
	
	// 加密配置文件内容为: 
	// {
	//   "db": {
	//     "password": "enc:AES:U2FsdGVkX1+3v2ZJ6ZvXoQ=="
	//   }
	// }
	
	// 自动解密
	dbPass := o.GetString("db.password")
	fmt.Println(dbPass) // 输出解密后的密码
}

热加载配置

onion支持配置热加载：

func main() {
	o := onion.New()
	
	// 创建可热加载的文件层
	layer, err := onion.NewFileLayerWithReload("./config.yaml", time.Minute)
	if err != nil {
		log.Fatal(err)
	}
	o.AddLayer(layer)
	
	// 定期检查配置变化
	go func() {
		for range time.Tick(30 * time.Second) {
			if o.ReloadIfNeeded() {
				log.Println("Configuration reloaded")
			}
		}
	}()
}

结构体绑定

可以将配置绑定到结构体：

type Config struct {
	Server struct {
		Port int `onion:"port"`
		Host string `onion:"host"`
	} `onion:"server"`
	Debug bool `onion:"debug"`
}

func main() {
	o := onion.New()
	o.AddLayer(onion.NewFileLayer("./config.yaml"))
	
	var cfg Config
	if err := o.Bind(&cfg); err != nil {
		log.Fatal(err)
	}
	
	fmt.Printf("Server: %s:%d, Debug: %v\n", cfg.Server.Host, cfg.Server.Port, cfg.Debug)
}

完整示例

package main

import (
	"flag"
	"fmt"
	"log"
	"time"
	
	"github.com/goraz/onion"
	"github.com/goraz/onion/crypto"
)

func main() {
	// 命令行参数
	flag.Int("port", 0, "Server port")
	flag.Parse()
	
	// 创建配置
	o := onion.New()
	
	// 1. 默认值
	defaults := map[string]interface{}{
		"server.port": 8080,
		"server.host": "localhost",
		"debug":       false,
	}
	o.AddLayer(onion.NewMapLayer(defaults))
	
	// 2. JSON配置文件
	o.AddLayer(onion.NewFileLayer("./config.json"))
	
	// 3. 加密配置层
	enc := crypto.NewAES([]byte("my-32-byte-aes-encryption-key"))
	o.AddLayer(crypto.NewLayer(enc))
	
	// 4. 环境变量
	o.AddLayer(onion.NewEnvLayer("APP_", true))
	
	// 5. 命令行参数
	o.AddLayer(onion.NewFlagLayer(flag.CommandLine))
	
	// 热加载配置
	layer, err := onion.NewFileLayerWithReload("./config.json", time.Minute)
	if err == nil {
		o.AddLayer(layer)
		go watchConfig(o)
	}
	
	// 使用配置
	startServer(o)
}

func watchConfig(o *onion.Onion) {
	for range time.Tick(30 * time.Second) {
		if o.ReloadIfNeeded() {
			log.Println("Configuration reloaded")
		}
	}
}

func startServer(o *onion.Onion) {
	port := o.GetInt("server.port")
	host := o.GetString("server.host")
	debug := o.GetBool("debug")
	
	fmt.Printf("Starting server on %s:%d, debug mode: %v\n", host, port, debug)
}

总结

onion库提供了强大的配置管理功能：

1. 支持多层配置源叠加
2. 内置加密配置支持
3. 支持热加载配置
4. 提供结构体绑定
5. 支持多种配置格式(JSON/YAML/Env/Flag等)

通过合理使用这些功能，可以构建灵活、安全的应用程序配置系统。