SessionHandlerInterface::read

セッションのデータを読み込む

説明

public stringfalse SessionHandlerInterface::read(string $id)

セッションのデータをセッションストレージから読み込み、その結果を返します。 セッションを開始した直後、あるいは session_start を実行したときにコールされます。 このメソッドがコールされる直前に SessionHandlerInterface::open が実行されることに注意しましょう。

このメソッドは、セッションが開始するときに PHP 自身がコールします。 このメソッドは、指定したセッション ID のセッションデータをストレージから取得しなければなりません。 返す文字列の書式は、SessionHandlerInterface::write に渡されたものと同様にシリアライズされたものでなければなりません。 データが見つからない場合は false を返します。

このメソッドが返すデータは、PHP が内部的にデコードします。デコードに使うメソッドは session.serialize_handler で指定します。デコードした結果をスーパーグローバル $_SESSION に格納します。

シリアライズ方式は unserialize とは異なっており、アクセスするためには session_decode を使うことに注意しましょう。

パラメータ

id

セッション id。

戻り値

読み込んだデータをエンコードした文字列を返します。 何も読まなかった場合は false を返さなければなりません。 この値は、PHP が内部的に使うためだけのものであることに注意しましょう。