Beego/session

session

session is a Go session manager. It can use many session providers. Just like the database/sql and database/sql/driver.

How to install?

go get github.com/astaxie/beego/session

What providers are supported?

As of now this session manager support memory, file, Redis and MySQL.

How to use it?

First you must import it

import (
	"github.com/astaxie/beego/session"
)

Then in you web app init the global session manager

var globalSessions *session.Manager

• Use memory as provider:

    func init() {
    	globalSessions, _ = session.NewManager("memory", "gosessionid", 3600,"")
    	go globalSessions.GC()
    }
  

• Use MySQL as provider, the last param is the DNS, learn more from mysql:

    func init() {
    	globalSessions, _ = session.NewManager(
    		"mysql", "gosessionid", 3600, "username:password@protocol(address)/dbname?param=value")
    	go globalSessions.GC()
    }
  

• Use file as provider, the last param is the path where you want file to be stored:

    func init() {
    	globalSessions, _ = session.NewManager("file", "gosessionid", 3600, "./tmp")
    	go globalSessions.GC()
    }
  

• Use Redis as provider, the last param is the Redis conn address:

    func init() {
    	globalSessions, _ = session.NewManager("redis", "gosessionid", 3600, "127.0.0.1:6379")
    	go globalSessions.GC()
    }
  

Finally in the handlerfunc you can use it like this

func login(w http.ResponseWriter, r *http.Request) {
	sess := globalSessions.SessionStart(w, r)
	defer sess.SessionRelease()
	username := sess.Get("username")
	fmt.Println(username)
	if r.Method == "GET" {
		t, _ := template.ParseFiles("login.gtpl")
		t.Execute(w, nil)
	} else {
		fmt.Println("username:", r.Form["username"])
		sess.Set("username", r.Form["username"])
		fmt.Println("password:", r.Form["password"])
	}
}

How to write own provider?

When you develop a web app, maybe you want to write own provider because you must meet the requirements.

Writing a provider is easy. You only need to define two struct types (Session and Provider), which satisfy the interface definition. Maybe you will find the memory provider as good example.

type SessionStore interface {
	Set(key, value interface{}) error // set session value
	Get(key interface{}) interface{}  // get session value
	Delete(key interface{}) error     // delete session value
	SessionID() string                // return current sessionID
	SessionRelease()                  // release the resource
}

type Provider interface {
	SessionInit(maxlifetime int64, savePath string) error
	SessionRead(sid string) (SessionStore, error)
	SessionDestroy(sid string) error
	SessionGC()
}

LICENSE

BSD License http://creativecommons.org/licenses/BSD/