SessionHandler::write

セッションのデータを書き込む

説明

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

セッションのデータをセッションストレージに書き込みます。 リクエストの終了時や session_write_close を実行したとき、そして session_register_shutdown が失敗したときにコールされます。 PHP は、このメソッドの戻り値を受け取るとすぐに SessionHandler::close をコールします。

このメソッドは、このハンドラが session_set_save_handler で設定される前に ini 設定 session.save_handler で定義されていた PHP の保存ハンドラをラップします。

このクラスを継承して拡張する場合は、親の write メソッドをコールすればこのメソッドのラッパーを実行でき、それに付随する内部コールバックも実行されます。 こうすれば、メソッドをオーバーライドしたり処理を横取りしてフィルタを追加したり (親の write メソッドに送る前に $data を暗号化したりなど) できます。

このメソッドに関する詳細は、 SessionHandlerInterface::write のドキュメントを参照ください。

パラメータ

id

セッション id。

data

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

戻り値

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