gredis 组件支持两种方式来管理 redis 配置和获取 redis 对象，一种是通过 配置组件+单例对象 的方式；一种是模块化通过 配置管理方法 及对象创建方法。

配置文件（推荐）

绝大部分情况下推荐使用 g.Redis 单例方式来操作 redis。因此同样推荐使用配置文件来管理 Redis 配置，在 config.yaml 中的配置示例如下：

单实例配置

# Redis 配置示例
redis:
  # 单实例配置示例1
  default:
    address: 127.0.0.1:6379
    db:      1
  # 单实例配置示例2
  cache:
    address:     127.0.0.1:6379
    db:          1
    pass:        123456
    idleTimeout: 600

其中的 default 和 cache 分别表示配置分组名称，我们在程序中可以通过该名称获取对应配置的 redis 单例对象。不传递分组名称时，默认使用 redis.default 配置分组项)来获取对应配置的 redis 客户端单例对象。

集群化配置

# Redis 配置示例
redis:
   # 集群模式配置方法
  default:
    address: 127.0.0.1:6379,127.0.0.1:6370
    db:      1

配置项说明

使用示例：

config.yaml

# Redis 配置示例
redis:
  # 单实例配置示例1
  default:
    address: 127.0.0.1:6379
    db:      1
    pass:    "password" # 在此配置密码, 没有可去掉

package main
import (
    "fmt"
    _ "github.com/gogf/gf/contrib/nosql/redis/v2"
    "github.com/gogf/gf/v2/frame/g"
    "github.com/gogf/gf/v2/os/gctx"
)
func main() {
    var ctx = gctx.New()
    _, err := g.Redis().Set(ctx, "key", "value")
    if err != nil {
        g.Log().Fatal(ctx, err)
    }
    value, err := g.Redis().Get(ctx, "key")
    if err != nil {
        g.Log().Fatal(ctx, err)
    }
    fmt.Println(value.String())
}

执行后，输出结果为：

配置方法（高级）

由于 GoFrame 是模块化的框架，除了可以通过耦合且便捷的 g 模块来自动解析配置文件并获得单例对象之外，也支持有能力的开发者模块化使用 gredis 包。

gredis 提供了全局的分组配置功能，相关配置管理方法如下：

func SetConfig(config Config, name ...string)
func SetConfigByMap(m map[string]interface{}, name ...string) error
func GetConfig(name ...string) (config Config, ok bool)
func RemoveConfig(name ...string)
func ClearConfig()

使用示例：

package main
import (
    "fmt"
    _ "github.com/gogf/gf/contrib/nosql/redis/v2"
    "github.com/gogf/gf/v2/database/gredis"
    "github.com/gogf/gf/v2/frame/g"
    "github.com/gogf/gf/v2/os/gctx"
)
var (
    config = gredis.Config{
        Address: "127.0.0.1:6379",
        Db:      1,
        Pass:    "password",
    }
    group = "cache"
    ctx   = gctx.New()
)
func main() {
    gredis.SetConfig(&config, group)
    _, err := g.Redis(group).Set(ctx, "key", "value")
    if err != nil {
        g.Log().Fatal(ctx, err)
    }
    value, err := g.Redis(group).Get(ctx, "key")
    if err != nil {
        g.Log().Fatal(ctx, err)
    }
    fmt.Println(value.String())
}