https://github.com/go-session/session
A efficient, safely and easy-to-use session library for Go.
https://github.com/go-session/session
go-session go-sessions session session-manager
Last synced: 4 months ago
JSON representation
A efficient, safely and easy-to-use session library for Go.
- Host: GitHub
- URL: https://github.com/go-session/session
- Owner: go-session
- License: mit
- Created: 2016-07-20T00:44:31.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-07-17T03:23:46.000Z (almost 2 years ago)
- Last Synced: 2025-08-14T01:51:36.812Z (9 months ago)
- Topics: go-session, go-sessions, session, session-manager
- Language: Go
- Homepage: https://godoc.org/github.com/go-session/session
- Size: 53.7 KB
- Stars: 231
- Watchers: 4
- Forks: 41
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# session
> A efficient, safely and easy-to-use session library for Go.
[![Build][build-status-image]][build-status-url] [![Codecov][codecov-image]][codecov-url] [![ReportCard][reportcard-image]][reportcard-url] [![GoDoc][godoc-image]][godoc-url] [![License][license-image]][license-url]
## Quick Start
### Download and install
```bash
go get -v github.com/go-session/session/v3
```
### Create file `server.go`
```go
package main
import (
"context"
"fmt"
"net/http"
session "github.com/go-session/session/v3"
)
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
store, err := session.Start(context.Background(), w, r)
if err != nil {
fmt.Fprint(w, err)
return
}
store.Set("foo", "bar")
err = store.Save()
if err != nil {
fmt.Fprint(w, err)
return
}
http.Redirect(w, r, "/foo", 302)
})
http.HandleFunc("/foo", func(w http.ResponseWriter, r *http.Request) {
store, err := session.Start(context.Background(), w, r)
if err != nil {
fmt.Fprint(w, err)
return
}
foo, ok := store.Get("foo")
if ok {
fmt.Fprintf(w, "foo:%s", foo)
return
}
fmt.Fprint(w, "does not exist")
})
http.ListenAndServe(":8080", nil)
}
```
### Build and run
```bash
go build server.go
./server
```
### Open in your web browser
```text
foo:bar
```
## Features
- Easy to use
- Multi-storage support
- Multi-middleware support
- More secure, signature-based tamper-proof
- Context support
- Support request header and query parameters
## Store Implementations
- [https://github.com/go-session/redis](https://github.com/go-session/redis) - Redis
- [https://github.com/go-session/mongo](https://github.com/go-session/mongo) - MongoDB
- [https://github.com/go-session/gorm](https://github.com/go-session/gorm) - [GORM](https://github.com/jinzhu/gorm)
- [https://github.com/go-session/mysql](https://github.com/go-session/mysql) - MySQL
- [https://github.com/go-session/buntdb](https://github.com/go-session/buntdb) - [BuntDB](https://github.com/tidwall/buntdb)
- [https://github.com/go-session/cookie](https://github.com/go-session/cookie) - Cookie
## Middlewares
- [https://github.com/go-session/gin-session](https://github.com/go-session/gin-session) - [Gin](https://github.com/gin-gonic/gin)
- [https://github.com/go-session/beego-session](https://github.com/go-session/beego-session) - [Beego](https://github.com/astaxie/beego)
- [https://github.com/go-session/gear-session](https://github.com/go-session/gear-session) - [Gear](https://github.com/teambition/gear)
- [https://github.com/go-session/echo-session](https://github.com/go-session/echo-session) - [Echo](https://github.com/labstack/echo)
## MIT License
Copyright (c) 2021 Lyric
[build-status-url]: https://travis-ci.org/go-session/session
[build-status-image]: https://travis-ci.org/go-session/session.svg?branch=master
[codecov-url]: https://codecov.io/gh/go-session/session
[codecov-image]: https://codecov.io/gh/go-session/session/branch/master/graph/badge.svg
[reportcard-url]: https://goreportcard.com/report/github.com/go-session/session
[reportcard-image]: https://goreportcard.com/badge/github.com/go-session/session
[godoc-url]: https://godoc.org/github.com/go-session/session
[godoc-image]: https://godoc.org/github.com/go-session/session?status.svg
[license-url]: http://opensource.org/licenses/MIT
[license-image]: https://img.shields.io/npm/l/express.svg