Php/docs/class.sessionhandlerinterface

PHP Manual
Sessions
SessionHandlerInterface クラス

(PHP 5 >= 5.4.0, PHP 7)

はじめに

SessionHandlerInterface はカスタムセッションハンドラを作成する際の最低限のプロトタイプを定義したインターフェイスです。自作のセッションハンドラをオブジェクト指向型の起動方法で session_set_save_handler() に渡すために、このインターフェイスを実装することができます。

このクラスのコールバックメソッドは PHP が内部的にコールするものであり、ユーザーのコードから呼ばれることは想定していないことに注意しましょう。

クラス概要

SessionHandlerInterface {

/* メソッド */

abstract public close ( ) : bool

abstract public destroy ( string $id ) : bool

abstract public gc ( int $max_lifetime ) : int|bool

abstract public open ( string $path , string $name ) : bool

abstract public read ( string $id ) : string

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

}

例1 SessionHandlerInterface の使用例

この例では、ファイルベースのセッションストレージをつくります。これは PHP のデフォルトのセッション保存ハンドラである files と似たものです。この例をさらに拡張すれば、 PHP がサポートするお好みのデータベースを使ってセッションを保存させるようにするのも簡単です。

session_set_save_handler() でオブジェクト指向型のプロトタイプを使っていることと、シャットダウン関数をその parameter フラグで登録していることに注目しましょう。オブジェクトをセッション保存ハンドラとして使うときには、この方法をおすすめします。

警告コードを簡潔にするため、以下の例では入力値の検証を省略しています。しかし、$id パラメータはパストラバーサル問題のような脆弱性を避けるために、適切な検証/無害化が必須になる値です。 よって、ここで示した例を改変することなく、 本番の実環境で用いないでください

<?phpclass MySessionHandler implements SessionHandlerInterface{ private $savePath; public function open($savePath, $sessionName) { $this->savePath = $savePath; if (!is_dir($this->savePath)) { mkdir($this->savePath, 0777); } return true; } public function close() { return true; } public function read($id) { return (string)@file_get_contents("$this->savePath/sess_$id"); } public function write($id, $data) { return file_put_contents("$this->savePath/sess_$id", $data) === false ? false : true; } public function destroy($id) { $file = "$this->savePath/sess_$id"; if (file_exists($file)) { unlink($file); } return true; } public function gc($maxlifetime) { foreach (glob("$this->savePath/sess_*") as $file) { if (filemtime($file) + $maxlifetime < time() && file_exists($file)) { unlink($file); } } return true; }}$handler = new MySessionHandler();session_set_save_handler($handler, true);session_start();// $_SESSION への値の設定や格納されている値の取得を進めます

SessionHandlerInterface::close — セッションを閉じる
SessionHandlerInterface::destroy — セッションを破棄する
SessionHandlerInterface::gc — 古いセッションを削除する
SessionHandlerInterface::open — セッションを開始する
SessionHandlerInterface::read — セッションのデータを読み込む
SessionHandlerInterface::write — セッションのデータを書き込む

Php/docs/class.sessionhandlerinterface

はじめに

クラス概要

目次