普贤教程 › 包参考

session 包

Session 会话管理（纯函数，无 IO）

session.px — Session 会话管理（纯函数，无 IO）

项	值
包名	`session`
版本	`0.1.0`
入口	`session.px`
分类	`Web 与 HTTP`
文件数 / 行数	`1 / 97`

安装与引入

bash

pxpkg init          # 首次
pxpkg add session@0.1.0
pxpkg install

import session

所属分类教程：Web 与 HTTP

公开接口

函数	参数
`ss_new`	`opts`
`ss_start`	`store`
`ss_has`	`store, sid`
`ss_get`	`store, sid, key`
`ss_set`	`store, sid, key, val`
`ss_delete`	`store, sid, key`
`ss_destroy`	`store, sid`
`ss_gc`	`store, max_age`
`ss_all`	`store`
`ss_regenerate`	`store, sid`

其余 1 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`ss_gen_id`

包内说明（源码头注释）

text

session.px — Session 会话管理（纯函数，无 IO）
依赖: os_random_hex、now_sec（native）

函数列表:
ss_new(opts)                  → dict   # 创建会话存储
ss_start(store)               → string  # 启动会话，返回 session id
ss_get(store, sid, key)       → any    # 获取会话数据
ss_set(store, sid, key, val)  → bool   # 设置会话数据
ss_delete(store, sid, key)    → bool   # 删除会话键
ss_destroy(store, sid)        → bool   # 销毁会话
ss_gc(store, max_age)         → int    # 垃圾回收，返回清理数
ss_has(store, sid)            → bool   # 会话是否存在
ss_all(store)                 → list   # 列出所有 session id
ss_regenerate(store, sid)     → string  # 重新生成 session id