Name: sessions
Owner: Gorilla web toolkit
Description: Package gorilla/sessions provides cookie and filesystem sessions and infrastructure for custom session backends.
Created: 2012-10-02 21:33:02.0
Updated: 2018-01-19 02:30:50.0
Pushed: 2018-01-16 16:39:49.0
Homepage: http://www.gorillatoolkit.org/pkg/sessions
Size: 58
Language: Go
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
gorilla/sessions provides cookie and filesystem sessions and infrastructure for custom session backends.
The key features are:
Let's start with an example that shows the sessions API in a nutshell:
import (
"net/http"
"github.com/gorilla/sessions"
)
var store = sessions.NewCookieStore([]byte("something-very-secret"))
func MyHandler(w http.ResponseWriter, r *http.Request) {
// Get a session. We're ignoring the error resulted from decoding an
// existing session: Get() always returns a session, even if empty.
session, _ := store.Get(r, "session-name")
// Set some session values.
session.Values["foo"] = "bar"
session.Values[42] = 43
// Save it before we write to the response/return from the handler.
session.Save(r, w)
}
First we initialize a session store calling NewCookieStore() and passing a
secret key used to authenticate the session. Inside the handler, we call
store.Get() to retrieve an existing session or create a new one. Then we set
some session values in session.Values, which is a map[interface{}]interface{}.
And finally we call session.Save() to save the session in the response.
Important Note: If you aren't using gorilla/mux, you need to wrap your handlers
with
context.ClearHandler
or else you will leak memory! An easy way to do this is to wrap the top-level
mux when calling http.ListenAndServe:
http.ListenAndServe(":8080", context.ClearHandler(http.DefaultServeMux))
The ClearHandler function is provided by the gorilla/context package.
More examples are available on the Gorilla website.
Other implementations of the sessions.Store interface:
BSD licensed. See the LICENSE file for details.