# README
redistore
A session store backend for gorilla/sessions - src.
Requirements
Depends on the Redigo Redis library.
Installation
go get gopkg.in/boj/redistore.v1
Documentation
Available on godoc.org.
See http://www.gorillatoolkit.org/pkg/sessions for full documentation on underlying interface.
Example
// Fetch new store.
store, err := NewRediStore(10, "tcp", ":6379", "", []byte("secret-key"))
if err != nil {
panic(err)
}
defer store.Close()
// Get a session.
session, err = store.Get(req, "session-key")
if err != nil {
log.Error(err.Error())
}
// Add a value.
session.Values["foo"] = "bar"
// Save.
if err = sessions.Save(req, rsp); err != nil {
t.Fatalf("Error saving session: %v", err)
}
// Delete session.
session.Options.MaxAge = -1
if err = sessions.Save(req, rsp); err != nil {
t.Fatalf("Error saving session: %v", err)
}
// Change session storage configuration for MaxAge = 10 days.
store.SetMaxAge(10*24*3600)
# Functions
NewCookielessSessionIDStore creates a new CookielessSessionIDStore.
NewRediStore returns a new RediStore.
NewRediStoreWithDB - like NewRedisStore but accepts `DB` parameter to select redis DB instead of using the default one ("0").
NewRediStoreWithPool instantiates a RediStore with a *redis.Pool passed in.
# Structs
A CookielessSessionIDStore stores session ids in http headers.
GobSerializer uses gob package to encode the session map.
JSONSerializer encode the session map to JSON.
RediStore stores sessions in a redis backend.
# Interfaces
SessionSerializer provides an interface hook for alternative serializers.