SessionHandlerInterface::write

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

SessionHandlerInterface::write — Записать данные сессии

Описание

public SessionHandlerInterface::write(string $id, string $data): bool

Записывает данные сессии в хранилище сессий. Вызывается функцией session_write_close(), когда неудачно завершается функция session_register_shutdown() или во время нормального завершения работы. Внимание: SessionHandlerInterface::close() вызывается сразу же после этой функции.

PHP вызывает этот метод, когда сессия готова для сохранения и закрытия. Кодируются данные сессии из суперглобального массива $_SESSION в сериализованную строку и передаются вместе с идентификатором сессии данному методу для хранения. Используемый метод сериализации указан в опции session.serialize_handler.

Обратите внимание, что этот метод обычно вызывается PHP после закрытия буферов вывода, если явно не вызывается session_write_close().

Список параметров

id: Идентификатор сессии.
data: Закодированные данные сессии. Эти данные являются результатом внутреннего кодирования PHP суперглобального массива $_SESSION в сериализованную строку и передачи её в качестве этого параметра. Обратите внимание, что сессии используют альтернативный метод сериализации.

Возвращаемые значения

Возвращаемое значение сессионного хранилища (обычно true в случае успешного выполнения, false в случае возникновения ошибки). Данное значение возвращается обратно в PHP для внутренней обработки.

Смотрите также

Директива конфигурации session.serialize_handler

＋add a note

User Contributed Notes 3 notes

down

jotremb at hotmail dot com ¶

6 years ago


It is important to note that if returning FALSE from this method, PHP will in turn output the following warning:

Warning: Unknown: Failed to write session data (user). Please verify that the current setting of session.save_path is correct (/var/lib/php/session) in Unknown on line 0.

This could cause minor inconveniences, however if the session should not be written as per design, then returning TRUE after handling (and not writing) the session will avoid further issues.

All in all, better return TRUE at all times except in cases of hard errors.

down

barkoczi dot roland at aercode dot com ¶

7 years ago


Note: this function won't be called in case $session_data is unchanged. In order to call this function every time when session is about closing, add $_SESSION["timestamp"] = time();

down

Aeric Poon ¶

3 years ago


Warning: session_write_close(): Session callback expects true/false return value in Unknown on line 0

I have returned TRUE in write() but the warning still persist. Then I also return TRUE in close() and the warning is gone.

＋add a note