📌Getting started
🔌Routing
🗜️Compression
🖼️ View/Templates
📁File Server
🌎Localization
🛡️Security
🚀Responses
📥
Requests
💉Dependency Injection
Sessions
When you work with an application, you open it, do some changes, and then you close it. This is much like a Session. The computer knows who you are. It knows when you start the application and when you end. But on the internet there is one problem: the web server does not know who you are or what you do, because the HTTP address doesn't maintain state.
Session variables solve this problem by storing user information to be used across multiple pages (e.g. username, favorite color, etc). By default, session variables last until the user closes the browser.
So; Session variables hold information about one single user, and are available to all pages in one application.
Iris has its own session implementation and sessions manager live inside the iris/sessions subpackage. You'll need to import this package in order to work with HTTP Sessions.
A session is started with the
Start function of the Sessions object which is created with the New package-level function. That function will return a Session.Session variables are set with the
Session.Set method and retrieved by the Session.Get and its related methods. To delete a single variable use the Session.Delete. To delete and invalidate the whole session use the Session.Destroy method.See all methods The sessions manager is created using the `New` package-level function. ```go import "github.com/kataras/iris/v12/sessions" sess := sessions.New(sessions.Config{Cookie: "cookieName", ...}) ``` Where `Config` looks like that. ```go SessionIDGenerator func(iris.Context) string // Defaults to "irissessionid". Cookie string CookieSecureTLS bool // Defaults to false. AllowReclaim bool // Defaults to nil. Encode func(cookieName string, value interface{}) (string, error) // Defaults to nil. Decode func(cookieName string, cookieValue string, v interface{}) error // Defaults to nil. Encoding Encoding // Defaults to infinitive/unlimited life duration(0). Expires time.Duration // Defaults to false. DisableSubdomainPersistence bool ``` The return value a `Sessions` pointer exports the following methods. ```go Start(ctx iris.Context, cookieOptions ...iris.CookieOption) *Session Destroy() DestroyAll() DestroyByID(sessID string) OnDestroy(callback func(sid string)) ShiftExpiration(ctx iris.Context, cookieOptions ...iris.CookieOption) error UpdateExpiration(ctx iris.Context, expires time.Duration, cookieOptions ...iris.CookieOption) error UseDatabase(db Database) ``` Where `CookieOption` is just a `func(*iris.Cookie)` which allows to customize cookie's properties. The `Start` method returns a `Session` pointer value which exports its own methods to work per session. ```go func (ctx iris.Context) { session := sess.Start(ctx) .ID() string .IsNew() bool .Set(key string, value interface{}) .SetImmutable(key string, value interface{}) .GetAll() map[string]interface{} .Delete(key string) bool .Clear() .Get(key string) interface{} .GetString(key string) string .GetStringDefault(key string, defaultValue string) string .GetInt(key string) (int, error) .GetIntDefault(key string, defaultValue int) int .Increment(key string, n int) (newValue int) .Decrement(key string, n int) (newValue int) .GetInt64(key string) (int64, error) .GetInt64Default(key string, defaultValue int64) int64 .GetFloat32(key string) (float32, error) .GetFloat32Default(key string, defaultValue float32) float32 .GetFloat64(key string) (float64, error) .GetFloat64Default(key string, defaultValue float64) float64 .GetBoolean(key string) (bool, error) .GetBooleanDefault(key string, defaultValue bool) bool .SetFlash(key string, value interface{}) .HasFlash() bool .GetFlashes() map[string]interface{} .PeekFlash(key string) interface{} .GetFlash(key string) interface{} .GetFlashString(key string) string .GetFlashStringDefault(key string, defaultValue string) string .DeleteFlash(key string) .ClearFlashes() .Destroy() } ```
Example
In this example we will only allow authenticated users to view our secret message on the /secret age. To get access to it, the will first have to visit /login to get a valid session cookie, hich logs him in. Additionally he can visit /logout to revoke his access to our secret message.
1
// sessions.go
2
package main
3
4
import (
5
"github.com/kataras/iris/v12"
6
7
"github.com/kataras/iris/v12/sessions"
8
)
9
10
var (
11
cookieNameForSessionID = "mycookiesessionnameid"
12
sess = sessions.New(sessions.Config{Cookie: cookieNameForSessionID})
13
)
14
15
func secret(ctx iris.Context) {
16
// Check if user is authenticated
17
if auth, _ := sess.Start(ctx).GetBoolean("authenticated"); !auth {
18
ctx.StatusCode(iris.StatusForbidden)
19
return
20
}
21
22
// Print secret message
23
ctx.WriteString("The cake is a lie!")
24
}
25
26
func login(ctx iris.Context) {
27
session := sess.Start(ctx)
28
29
// Authentication goes here
30
// ...
31
32
// Set user as authenticated
33
session.Set("authenticated", true)
34
}
35
36
func logout(ctx iris.Context) {
37
session := sess.Start(ctx)
38
39
// Revoke users authentication
40
session.Set("authenticated", false)
41
// Or to remove the variable:
42
session.Delete("authenticated")
43
// Or destroy the whole session:
44
session.Destroy()
45
}
46
47
func main() {
48
app := iris.New()
49
50
app.Get("/secret", secret)
51
app.Get("/login", login)
52
app.Get("/logout", logout)
53
54
app.Listen(":8080")
55
}
Copied!
1
$ go run sessions.go
2
3
$ curl -s http://localhost:8080/secret
4
Forbidden
5
6
$ curl -s -I http://localhost:8080/login
7
Set-Cookie: mysessionid=MTQ4NzE5Mz...
8
9
$ curl -s --cookie "mysessionid=MTQ4NzE5Mz..." http://localhost:8080/secret
10
The cake is a lie!
Copied!
Midddleware
When you want to use the
Session in the same request handler and life cycle(chain of handlers, middlewares), you can optionally register it as a middleware and use the package-level sessions.Get to retrieve the stored-to-context session.The
Sessions struct value contains the Handler method which can be used to return an iris.Handler to be registered as middleware.1
import "github.com/kataras/iris/v12/sessions"
2
3
sess := sessions.New(sessions.Config{...})
4
5
app := iris.New()
6
app.Use(sess.Handler())
7
8
app.Get("/path", func(ctx iris.Context){
9
session := sessions.Get(ctx)
10
// [use session...]
11
})
Copied!
Also, if the sessions manager's
Config.AllowReclaim is true then you can still call sess.Start as many times as you want in the same request life cycle without the need of registering it as a middleware.Navigate to https://github.com/kataras/iris/tree/master/_examples/sessions for more examples about the sessions subpackage.
Last modified 1yr ago
Export as PDF
Copy link