PHP8.1会话如何存储到MongoDB-php教程-PHP中文网

PHP 8.1 不支持 session.save_handler = mongodb，必须实现 SessionHandlerInterface 并用 session_set_save_handler() 注册；read() 必须返回空字符串而非 null，write() 需更新 expires_at 以启用 TTL 自动清理。

php8.1会话如何存储到mongodb

PHP 8.1 默认会话仍存于文件系统，要存到 MongoDB 必须手动接管会话存储逻辑——不能只装扩展、不重写 session_set_save_handler()，否则 session_start() 依然读写 /tmp。

为什么不能直接用 `session.save_handler = mongodb`

PHP 内置的 session.save_handler 不支持 mongodb 值；它只认 files、redis、memcached 等少数几个。MongoDB 没有被编译进 PHP 核心，所以该配置项设成 mongodb 会被忽略，PHP 回退到默认的 files，且不报错。

必须实现自定义 SessionHandlerInterface

核心是用 MongoDB\Client 操作集合，并让 PHP 调用你的读/写/销毁等方法。关键点：

read($id) 必须返回字符串（不是数组），且若会话不存在，必须返回空字符串 ''，不能返回 null 或抛异常，否则 session_start() 失败
write($id, $session_data) 中的 $session_data 是 PHP 序列化后的原始字符串（类似 user|s:4:"john";login_time|i:1726583400;），别试图 json_decode 它
集合建议加 TTL 索引自动清理过期会话：$collection->createIndex(['expires_at' => 1], ['expireAfterSeconds' => 0])
务必在 write() 中更新 expires_at 字段，否则 TTL 不生效

示例片段：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

class MongoSessionHandler implements \SessionHandlerInterface
{
    private $collection;
    private $lifetime;
<pre class="brush:php;toolbar:false;">public function __construct(MongoDB\Collection $collection, int $lifetime = 1440)
{
    $this->collection = $collection;
    $this->lifetime   = $lifetime;
}

public function read($id): string
{
    $doc = $this->collection->findOne(['_id' => $id]);
    return $doc && isset($doc['data']) ? (string)$doc['data'] : '';
}

public function write($id, $session_data): bool
{
    $expires = new MongoDB\BSON\UTCDateTime(strtotime("+{$this->lifetime} seconds") * 1000);
    $this->collection->updateOne(
        ['_id' => $id],
        [
            '$set' => [
                'data'      => $session_data,
                'expires_at'=> $expires,
            ],
            '$setOnInsert' => ['created_at' => new MongoDB\BSON\UTCDateTime()],
        ],
        ['upsert' => true]
    );
    return true;
}

// ... 其他方法（open/close/destroy/gc）需完整实现

}