PHP マニュアル
前のページ |  | 次のページ

# session_set_save_handler

(PHP 4, PHP 5)

session_set_save_handler -- ユーザ定義のセッション保存関数を設定する

## 説明

bool session_set_save_handler ( callback open, callback close, callback read, callback write, callback destroy, callback gc )

session_set_save_handler() は、セッションに 関連するデータを保存および取得するために使用されるユーザ定義の セッション保存関数を設定します。この関数は、セッションデータを ローカルデータベースに保存する場合のように PHP セッションにより 提供されるもの以外の保存方法を使用したい場合に有用です。 成功した場合に `TRUE` を、失敗した場合に `FALSE` を返します。

> 注意: セッションが何も情報を含んでいない場合には write ハンドラは実行されません。 空のセッション変数が登録されている場合でも同様です。 この動作はデフォルトのファイルベースセッションハンドラとは異なるものです。 デフォルトのファイルベースセッションハンドラは空のセッションファイルを 生成します。

以下の例では、デフォルトの保存 files に似た ファイルベースのセッション保存を行います。この例は、PHP がサポート する任意のデータベースエンジンを用いてデータベースへの保存を行う ように容易に拡張可能です。

save ハンドラが期待通りに動作するように read 関数は常に文字列を返す 必要があります。データがない場合には、空の文字列を返してください。 他のハンドラからの返り値は、論理式、すなわち成功した場合に `TRUE`、 失敗した場合に `FALSE` を返します。

警告
PHP 5.0.5 以降、Write ハンドラおよび Close ハンドラはオブジェクトが 破棄されたあとにコールされます。そのため、セッション内でデストラクタを 使用可能ですが、ハンドラ内ではオブジェクトを使用できません。 以前のバージョンでは、これらのコールされる順序が逆でした。 この「ニワトリが先かタマゴが先か」の問題を解決するために、 デストラクタから session_write_close() を コールすることが可能です。

例 1. session_set_save_handler() の例
`<?php function open($save_path, $session_name) { global $sess_save_path, $sess_session_name; $sess_save_path = $save_path; $sess_session_name = $session_name; return(true); } function close() { return(true); } function read($id) { global $sess_save_path, $sess_session_name; $sess_file = "$sess_save_path/sess_$id"; if ($fp = @fopen($sess_file, "r")) { $sess_data = fread($fp, filesize($sess_file)); return($sess_data); } else { return(""); // ここで "" を返す必要があります。 } } function write($id, $sess_data) { global $sess_save_path, $sess_session_name; $sess_file = "$sess_save_path/sess_$id"; if ($fp = @fopen($sess_file, "w")) { return(fwrite($fp, $sess_data)); } else { return(false); } } function destroy($id) { global $sess_save_path, $sess_session_name; $sess_file = "$sess_save_path/sess_$id"; return(@unlink($sess_file)); } /********************************************* * 警告 - ここで何らかのガベージコレクション * * ルーチンを実装する必要があるでしょう。 * *********************************************/ function gc($maxlifetime) { return true; } session_set_save_handler("open", "close", "read", "write", "destroy", "gc"); session_start(); // セッションを通常通り使用します。 ?>`

session.save_handler 設定ディレクティブも参照してください。

前のページ | ホーム | 次のページ
session_set_cookie_params | 上に戻る | session_start