Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

session

package

Go to main page

Versions in this module

v0

v0.9.0

Jan 8, 2026

v0.8.1

Jan 3, 2026

v0.8.0

Jan 2, 2026

Changes in this version

+ const DefaultCookie

+ const DefaultExpirationDelta

+ const DefaultTTL

+ var ErrCacheDriverInvalidType = errors.New("invalid cache type")

+ func Middleware(driver contract.SessionDriver) framework.Middleware

+ func MiddlewareWith(driver contract.SessionDriver, options MiddlewareOptions) framework.Middleware

+ type CacheDriver struct

+ func NewCacheDriver(cache contract.Cache) *CacheDriver

+ func NewCacheDriverWith(cache contract.Cache, options CacheDriverOptions) *CacheDriver

+ func (d *CacheDriver) Delete(ctx context.Context, id string) error

+ func (d *CacheDriver) Get(ctx context.Context, id string) (contract.Session, error)

+ func (d *CacheDriver) Save(ctx context.Context, session contract.Session, ttl time.Duration) error

+ type CacheDriverOptions struct

+ type MiddlewareOptions struct

+ Domain string

+ ExpirationDelta time.Duration

+ Key any

+ Name string

+ Partitioned bool

+ Path string

+ SameSite http.SameSite

+ Secure bool

+ TTL time.Duration

v0.7.0

Dec 21, 2025

Changes in this version

type Session

+ func (s *Session) MarkAsUnchanged()

v0.6.0

Dec 19, 2025

v0.5.1

Dec 19, 2025

v0.5.0

Dec 17, 2025

Changes in this version

+ var Key = sessionKey

+ type Session struct

+ Expiration time.Time

+ ID string

+ OriginalID string

+ Storage map[string]any

+ func NewSession(expiresAt time.Time, storage map[string]any) (*Session, error)

+ func (s *Session) Clear()

+ func (s *Session) Delete(key string)

+ func (s *Session) ExpiresAt() time.Time

+ func (s *Session) ExpiresSoon(delta time.Duration) bool

+ func (s *Session) Extend(expiresAt time.Time)

+ func (s *Session) Get(key string) (any, bool)

+ func (s *Session) HasChanged() bool

+ func (s *Session) HasExpired() bool

+ func (s *Session) HasRegenerated() bool

+ func (s *Session) OriginalSessionID() string

+ func (s *Session) Put(key string, value any)

+ func (s *Session) Regenerate(expiresAt time.Time) error

+ func (s *Session) SessionID() string