Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
goframe框架支持两种方式来管理gredis组件支持两种方式来管理redis配置和获取redis对象,一种是通过配置文件+单例对象的方式;一种是模块化通过配置管理方法及对象创建方法。对象,一种是通过配置组件+单例对象的方式;一种是模块化通过配置管理方法及对象创建方法。

配置文件(推荐)

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

单实例配置

Code Block
languageyml
# Redis 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 客户端单例对象。

集群化配置

Code Block
languageyml
# Redis 配置示例
redis:
   # 集群模式配置方法
  groupdefault:	
    address: 127.0.0.1:6379,127.0.0.1:6370
    db:      1
各配置项说明如下:

配置项说明

等待连接池连接的超时时间TCP连接的超时时间TCP的Read操作超时时间TCP的Write操作超时时间 设置MasterName
配置项名称是否必须默认值说明

address

-

格式:地址+端口. 使用:分割地址和端口。支持单个和集群配置,使用,分割多个地址。:端口

支持Redis单实例模式和集群模式配置,使用,分割多个地址。例如:

eg:192.168.1.1:6379, 192.168.1.2:6379

db0数据库索引
user-访问授权用户数据库
pass-授权密码访问授权密码

minIdle

0允许闲置的最小连接数
maxIdle10允许闲置的最大连接数(0表示不限制0表示不限制)
maxActive100最大连接数量限制(0表示不限制0表示不限制)
idleTimeout10连接最大空闲时间(单位秒,不允许设置为0)连接最大空闲时间,使用时间字符串例如30s/1m/1d
maxConnLifetime30连接最长存活时间(单位秒,不允许设置为0)连接最长存活时间,使用时间字符串例如30s/1m/1d

waitTimeout

0等待连接池连接的超时时间,使用时间字符串例如30s/1m/1d

dialTimeout

0TCP连接的超时时间,使用时间字符串例如30s/1m/1d

readTimeout

0TCPRead操作超时时间,使用时间字符串例如30s/1m/1d

writeTimeout

0TCPWrite操作超时时间,使用时间字符串例如30s/1m/1d

masterName

-哨兵模式下使用, 设置MasterName
tlsfalse是否使用TLS认证是否使用TLS认证

tlsSkipVerify

false通过TLS连接时,是否禁用服务器名称验证
clusterfalse是否强制设置为集群工作模式。当address是单个endpoint的集群时,系统会自动判定为单实例模式,这时需要设置此项为true
protocol3设置与Redis Server通信的RESP协议版本。

sentinelUsername


Sentinel模式下的账号

sentinelPassword


Sentinel模式下的密码通过TLS连接时,是否禁用服务器名称验证

使用示例:

config.yaml

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


Code Block
languagego
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 = contextgctx.BackgroundNew()
	)
	conn_, _err := g.Redis().ConnSet(ctx)
	conn.Do(ctx, "SETkey", "Key", "Value")
	v, _value")
	if err != nil {
		g.Log().Fatal(ctx, err)
	}
	value, err := conn.Dog.Redis().Get(ctx, "GET", "Key")key")
	if err != nil {
		g.Log().Fatal(ctx, err)
	}
	fmt.Println(vvalue.String())
}

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

执行后,输出结果为:

Code Block
languagehtml
value
Value

配置方法(高级)

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

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

Code Block
languagego
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()

使用示例:

Code Block
languagego

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

func Instance(name ...string) *Redis
使用示例:
package main

import (
	"fmt"

	_ "github.com/gogf/gf/contrib/nosql/redis/v2"

	"github.com/gogf/gf/v2/database/gredis"
	"github.com/gogf/gf
/util/gconv
/v2/frame/g"
	"github.com/gogf/gf/v2/os/gctx"
)

var (
	config = gredis.Config{
		
Host
Address: "127.0.0.1:6379",
		
Port : 6379
Db:      1,
		
Db
Pass:   
:
 
1
"password",
	}
	group = "cache"
	ctx   = gctx.New()
)

func main() {
	
group := "test"
gredis.SetConfig(&config, group)

	
redis
_, err := 
gredis
g.
Instance
Redis(group)
defer redis
.
Close() _, err := redis.Do("SET
Set(ctx, "key", "
k", "v"
value")
	if err != nil {
		
panic(
g.Log().Fatal(ctx, err)
	}

	
r
value, err := 
redis.Do("GET"
g.Redis(group).Get(ctx, "
k
key")
	if err != nil {
		
panic(
g.Log().Fatal(ctx, err)
	}
	fmt.Println(
gconv
value.String(
r
))
}




Panel
titleContent Menu

Table of Contents