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 のセッションデータをエンコードして 文字列にシリアライズし、セッション ID とともにこのメソッドに渡して格納させます。 シリアライズの方式は session.serialize_handler で設定します。

このメソッドが PHP からコールされるのは、通常は出力バッファが閉じた後であることに注意しましょう。ただし、 明示的に session_write_close() をコールした場合は別です。

パラメータ

id

セッション id。

data

エンコードされたセッションデータ。 これは、PHP がスーパーグローバル $_SESSION の内容を内部的にシリアライズした結果の文字列で、それがこのパラメータに渡されます。 セッションのシリアライズには通常とは別の方式を使っていることに注意しましょう。

戻り値

返り値 (通常は、true が成功そして false が失敗を表します)。この値は PHP で内部的に処理されるものであることに注意しましょう。

関連キーワード:  セッション, データ, SessionHandlerInterface, 通常, 注意, コール, メソッド, data, スーパー, 内部