gf框架支持两种方式来管理redis配置和获取redis对象,一种是通过配置文件+单例对象的方式;一种是模块化通过配置管理方法及对象创建方法。

配置文件(推荐)

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

  1. # Redis数据库配置
  2. [redis]
  3. default = "127.0.0.1:6379,0"
  4. cache = "127.0.0.1:6379,1,123456?idleTimeout=600"

其中,Redis的配置格式为:host:port[,db,pass?maxIdle=x&maxActive=x&idleTimeout=x&maxConnLifetime=x]

各配置项说明如下:

配置项名称是否必须默认值说明
host-地址
port-端口
db0数据库
pass-授权密码
maxIdle10允许闲置的连接数(0表示不限制)
maxActive100最大连接数量限制(0表示不限制)
idleTimeout10连接最大空闲时间(单位秒,不允许设置为0)
maxConnLifetime30连接最长存活时间(单位秒,不允许设置为0)
tlsfalse是否使用TLS认证
skipVerifyfalse通过TLS连接时,是否禁用服务器名称验证

使用示例:

  1. package main
  2. import (
  3. "fmt"
  4. "github.com/gogf/gf/frame/g"
  5. "github.com/gogf/gf/util/gconv"
  6. )
  7. func main() {
  8. g.Redis().DoVar("SET", "k", "v")
  9. v, _ := g.Redis().DoVar("GET", "k")
  10. fmt.Println(v.String())
  11. }

其中的defaultcache分别表示配置分组名称,我们在程序中可以通过该名称获取对应配置的redis单例对象。不传递分组名称时,默认使用redis.default配置分组项)来获取对应配置的redis客户端单例对象。 执行后,输出结果为:

  1. v

配置方法(高级)

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

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

  1. func SetConfig(config Config, name ...string)
  2. func GetConfig(name ...string) (config Config, ok bool)
  3. func RemoveConfig(name ...string)
  4. func ClearConfig()

其中name参数为分组名称,即为通过分组来对配置对象进行管理,我们可以为不同的配置对象设置不同的分组名称,随后我们可以通过Instance单例方法获取redis客户端操作对象单例。

  1. func Instance(name ...string) *Redis

使用示例:

  1. package main
  2. import (
  3. "fmt"
  4. "github.com/gogf/gf/database/gredis"
  5. "github.com/gogf/gf/util/gconv"
  6. )
  7. var (
  8. config = gredis.Config{
  9. Host : "127.0.0.1",
  10. Port : 6379,
  11. Db : 1,
  12. }
  13. )
  14. func main() {
  15. group := "test"
  16. gredis.SetConfig(config, group)
  17. redis := gredis.Instance(group)
  18. defer redis.Close()
  19. _, err := redis.Do("SET", "k", "v")
  20. if err != nil {
  21. panic(err)
  22. }
  23. r, err := redis.Do("GET", "k")
  24. if err != nil {
  25. panic(err)
  26. }
  27. fmt.Println(gconv.String(r))
  28. }