Struct SessionConfig 

pub struct SessionConfig { /* private fields */ }

Session backend configuration.

Created via SessionConfig::kv() or SessionConfig::d1() and passed to Handler::session().

Implementations

impl SessionConfig

pub fn kv(binding: &str) -> Self

Create a KV-backed session configuration.

binding is the KV namespace binding name from wrangler.toml. Sessions are automatically expired using KV’s expiration_ttl.

Example

Handler::new()
    .session(SessionConfig::kv("SESSIONS"))
    .handle(req, env)
    .await

pub fn d1(binding: &str, table: &str) -> Self

Create a D1-backed session configuration.

binding is the D1 database binding name and table is the table name. The table must exist with schema:

CREATE TABLE sessions (
    id TEXT PRIMARY KEY,
    data TEXT NOT NULL,
    expires_at INTEGER NOT NULL
);

Expired sessions are filtered at read time via expires_at > unixepoch().

Example

Handler::new()
    .session(SessionConfig::d1("DB", "sessions"))
    .handle(req, env)
    .await

pub fn cookie_name(self, name: &str) -> Self

Set the cookie name. Default: "__session".

pub fn max_age(self, secs: u64) -> Self

Set the session max age in seconds. Default: 86400 (24 hours).

This controls both the cookie Max-Age and the backend expiry (KV expiration_ttl or D1 expires_at).

Trait Implementations

impl Clone for SessionConfig

fn clone(&self) -> SessionConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.