name: Session control

sort: 5

Session control

Beego has a built-in session module that supports memory, file, mysql, redis, couchbase, memcache and postgres as the save provider. Other providers can be implemented according to the interface.

To use session in Beego switch it on in the main function:

  1. beego.BConfig.WebConfig.Session.SessionOn = true

Or it can be activated in the configuration file:

  1. SessionOn = true

After being swited on, session can used like this:

  1. func (this *MainController) Get() {
  2.     v := this.GetSession("asta")
  3.     if v == nil {
  4.         this.SetSession("asta", int(1))
  5.         this.Data["num"] = 0
  6.     } else {
  7.         this.SetSession("asta", v.(int)+1)
  8.         this.Data["num"] = v.(int)
  9.     }
  10.     this.TplNames = "index.tpl"
  11. }

There are several useful methods to handle session:

  • SetSession(name string, value interface{})
  • GetSession(name string) interface{}
  • DelSession(name string)
  • SessionRegenerateID()
  • DestroySession()

The most commonly used methods are SetSession, GetSession, and DelSession.

Custom logic can also be used:

  1. sess := this.StartSession()
  2. defer sess.SessionRelease()

sess object has following methods:

  • Set
  • Get
  • Delete
  • SessionID
  • SessionRelease
  • Flush

SetSession, GetSession and DelSession methods are recommended for session operation as it will release resource automatically.

Here are some parameters used in the Session module:

  • SessionOn

    Enables Session. Default value is false. Parameter name in configuration file: SessionOn

  • SessionProvider Sets Session provider. Set to memory by default. File, mysql and redis are also supported. Parameter name in configuration file: sessionprovider.

  • SessionName Sets the cookie name. Session is stored in browser’s cookies by default. The default name is beegosessionID. Parameter name in configuration file: sessionname.

  • SessionGCMaxLifetime Sets the Session expire time. Default value is 3600s. Parameter name in configuration file: sessiongcmaxlifetime.

  • SessionProviderConfig Sets the save path or connection string for file, mysql or redis. Default value is empty. Parameter name in configuration file: sessionproviderconfig.

  • SessionHashFunc Sets the function used to generate sessionid. The default value is sha1.

  • SessionCookieLifeTime Sets the cookie expire time. The cookie is used to store data in client.

From Beego version 1.1.3 onwards Beego removed all dependencies. Mysql, redis, couchbase, memcache, or postgres should be installed before they can be used.

  1. go get -u github.com/astaxie/beego/session/mysql

then import them in main.go, the same as the database/sql:

  1. import _ "github.com/astaxie/beego/session/mysql"

When SessionProvider is file, SessionProviderConfig is the save path for session files. For example:

  1. beego.BConfig.WebConfig.Session.SessionProvider = "file"
  2. beego.BConfig.WebConfig.Session.SessionProviderConfig = "./tmp"

When SessionProvider is mysql, SessionProviderConfig is the connection address using go-sql-driver. For example:

  1. beego.BConfig.WebConfig.Session.SessionProvider = "mysql"
  2. beego.BConfig.WebConfig.Session.SessionProviderConfig = "username:password@protocol(address)/dbname?param=value"

When SessionProvider is redis, SessionProviderConfig is the connection address using redigo. For example:

  1. beego.BConfig.WebConfig.Session.SessionProvider = "redis"
  2. beego.BConfig.WebConfig.Session.SessionProviderConfig = "127.0.0.1:6379"

When SessionProvider is memcache，SessionProviderConfig is the connection address using memcache. For example

  1. beego.BConfig.WebConfig.Session.SessionProvider = "memcache"
  2. beego.BConfig.WebConfig.Session.SessionProviderConfig = "127.0.0.1:7080"

When SessionProvider is postgres，SessionProviderConfig is the connection address using postgres. For example：

  1. beego.BConfig.WebConfig.Session.SessionProvider = "postgresql"
  2. beego.BConfig.WebConfig.Session.SessionProviderConfig = "postgres://pqgotest:password@localhost/pqgotest?sslmode=verify-full"

When SessionProvider is couchbase，SessionProviderConfig is connection address using couchbase. For example：

  1. beego.BConfig.WebConfig.Session.SessionProvider = "couchbase"
  2. beego.BConfig.WebConfig.Session.SessionProviderConfig = "http://bucketname:bucketpass@myserver:8091/"

Note:

Session uses gob to register objects. When using a session engine other than memory, objects must be registered in session before they can be used. Use gob.Register() to register them in init() function.