SessionHandlerInterface::read

(PHP 5 >= 5.4.0, PHP 7)

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

説明

abstract public SessionHandlerInterface::read ( string $session_id ) : string

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

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

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

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

パラメータ

session_id

セッション id。

返り値

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