session

Session Management Example

This example demonstrates how to use session management in DotWeb.

Features

• Enable session middleware
• Set/Get session values
• Check session existence
• Destroy session (logout)

Running

cd example/session
go run main.go

Testing

# Login - set session
curl http://localhost:8080/login
# Output: ✅ Logged in as Alice (admin)

# Get user info from session
curl http://localhost:8080/user
# Output: 👤 User: Alice
#         🔑 Role: admin

# Check session exists
curl http://localhost:8080/check
# Output: ✅ Session exists

# Logout - destroy session
curl http://localhost:8080/logout
# Output: ✅ Logged out successfully

# Check session again
curl http://localhost:8080/check
# Output: ❌ No session found

Session Configuration

Runtime Mode (Default)

app.HttpServer.SetSessionConfig(session.NewDefaultRuntimeConfig())

Session data is stored in memory. Good for development and single-instance deployment.

Redis Mode

// Without auth
app.HttpServer.SetSessionConfig(
    session.NewDefaultRedisConfig("redis://192.168.1.100:6379/0"),
)

// With auth
app.HttpServer.SetSessionConfig(
    session.NewDefaultRedisConfig("redis://:password@192.168.1.100:6379/0"),
)

Session data is stored in Redis. Recommended for production with multiple instances.

API Reference

Notes

• Sessions are identified by a cookie named DOTWEB_SESSION_ID by default
• Session ID is automatically generated and managed by DotWeb
• Always enable session before using: app.HttpServer.SetEnabledSession(true)