Goframe gredis configuration management | comparison of configuration files and configuration methods

Keep creating , Accelerate growth ！ This is my participation 「 Nuggets day new plan · 6 Yuegengwen challenge 」 Of the 18 God , Click to see the event details

Preface abstract

The last article introduced GoFrame gcache Use practice | Cache control Elimination strategy , Got positive feedback from everyone .

The next few articles have made persistent efforts , Still introduce to you GoFrame Framework cache related knowledge points , And some summary thoughts in the use of my project ,GoFrame The framework is hereinafter referred to as gf.

GoFrame gredis

goframe The framework supports two ways to manage redis Configure and get redis object , One is through the configuration file + Singleton objects ; One is the modular configuration management method and object creation method .

We use the former ： Through the configuration file + Singleton objects .

The configuration file （ recommend ）

In most cases, it is recommended to use g.Redis Single instance operation redis.

It is recommended to use the configuration file to manage Redis To configure , stay config.toml The configuration example in is as follows ：

# Redis Database configuration 
[redis]
    default = "127.0.0.1:6379,0"
    cache   = "127.0.0.1:6379,1,123456?idleTimeout=600"
 Copy code 

among ,Redis The configuration format of is ：

host:port[,db,pass?maxIdle=x&maxActive=x&idleTimeout=x&maxConnLifetime=x]

The configuration items are described as follows ：

Configuration item name	Whether must	The default value is	explain
host	yes	-	Address
port	yes	-	port
db	no	0	database
pass	no	-	Authorization code
maxIdle	no	10	Number of idle connections allowed (0 Means unrestricted )
maxActive	no	100	The maximum number of connections is limited (0 Means unrestricted )
idleTimeout	no	10	Maximum connection idle time ( Unit second , Setting to... Is not allowed 0)
maxConnLifetime	no	30	Maximum connection lifetime ( Unit second , Setting to... Is not allowed 0)
tls	no	false	Whether to use TLS authentication
skipVerify	no	false	adopt TLS When the connection , Whether to disable server name validation

Among them default and cache Respectively represents the name of the configuration group , In the program, we can get the corresponding configuration through this name redis Singleton object .

When the group name is not passed , By default redis.default Configure grouped items ) To get the corresponding configuration redis Client singleton object . After execution , The output is ：

Examples of use ：

package main

import (
    "fmt"
    "github.com/gogf/gf/frame/g"
    "github.com/gogf/gf/util/gconv"
)

func main() {
    g.Redis().DoVar("SET", "k", "v")
    v, _ := g.Redis().DoVar("GET", "k")
    fmt.Println(v.String())
}
 Copy code 

Print the results

v
 Copy code 

Configuration method （ senior ）

because gf Is a modular framework , In addition to the coupling and convenience g Module to automatically parse configuration files and obtain singleton objects , It also supports developers' modular use gredis package .

But this usage is relatively demanding for developers .

gredis It provides global grouping configuration function , The relevant configuration management methods are as follows ：

func SetConfig(config Config, name ...string)
func GetConfig(name ...string) (config Config, ok bool)
func RemoveConfig(name ...string)
func ClearConfig()
 Copy code 

among name The parameter is the group name , That is, to manage configuration objects by grouping , We can set different group names for different configuration objects , Then we can pass Instance Singleton method acquisition redis Client operation object singleton .

func Instance(name ...string) *Redis
 Copy code 

Examples of use ：

package main

import (
	"fmt"
	"github.com/gogf/gf/database/gredis"
	"github.com/gogf/gf/util/gconv"
)

var (
	config = gredis.Config{
		Host : "127.0.0.1",
		Port : 6379,
		Db   : 0,
	}
)

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

	redis := gredis.Instance(group)
	defer redis.Close()

	_, err := redis.Do("SET", "k", "v")
	if err != nil {
		panic(err)
	}

	r, err := redis.Do("GET", "k")
	if err != nil {
		panic(err)
	}
	fmt.Println(gconv.String(r))
}
 Copy code 

summary

gredis There are many relevant knowledge points , So I plan to split it into several articles for updating .

This article mainly introduces gredis Configuration mode ： Support configuration file management , It also supports management through configuration methods .

We use the officially recommended configuration file management method ： The method of configuration file management also supports sub databases .

Last

Thank you for reading , Welcome to the third company ： give the thumbs-up 、 Collection 、 Coin-operated （ Focus on ）！！！