SessionHandler::read

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

SessionHandler::read读取会话数据

描述

public SessionHandler::read(string $id): string|false

从会话存储中读取会话数据,并将结果返回给 PHP 以供内部处理。当会话启动时(无论是自动启动还是通过 session_start() 显式启动),PHP 会自动调用此方法,并在内部调用 SessionHandler::open() 之后进行调用。

此方法包装了在 session.save_handler ini 设置中定义的 PHP 内部保存处理程序,该设置是在 session_set_save_handler() 设置此处理程序之前设置的。

如果通过继承扩展此类,调用父 read 方法将调用此方法的包装器,从而调用关联的内部回调。这允许覆盖或拦截和过滤方法(例如,解密父 read 方法返回的 $data 值)。

有关此方法预期执行的操作的更多信息,请参阅 SessionHandlerInterface::read() 的文档。

参数

id

要读取数据的会话 ID。

返回值

返回读取数据的编码字符串。如果未读取任何内容,则必须返回 false。请注意,此值将内部返回给 PHP 以供处理。

参见

添加注释

用户贡献的注释 1 个注释

andrey at puhovsky dot com
1 年前
请注意,您必须仅对 PHP 8+ 返回 false。

对于旧版本,您必须返回空字符串,否则您将收到错误“警告:session_start(): 无法读取会话数据:用户 (路径:127.0.0.1:9999)”。
To Top