session_set_save_handler
(PHP 4, PHP 5)
session_set_save_handler --
ユーザ定義のセッション保存関数を設定する
説明
bool
session_set_save_handler ( string open, string close, string read, string write, string destroy, string gc )
session_set_save_handler() は、セッションに関
連するデータを保存および取得するために使用されるユーザ定義のセッ
ション保存関数を設定します。この関数は、セッションデータをローカ
ルデータベースに保存する場合のようにPHPセッションにより提供される
もの以外の保存方法を使用したい場合に有用です。
成功した場合に TRUE を、失敗した場合に FALSE を返します。
注意:
"write" ハンドラは、出力ストリームがクローズされるまでは実行され
ません。つまり、"write"ハンドラにおけるデバッグ用出力はブラウザ
側では見ることができません。デバッグ用の出力が必要な場合は、代わ
りにデバッグ出力をファイルに書き込むことを推奨します。
注意:
セッションが何も情報を含んでいない場合にはwriteハンドラは実行されません。
空のセッション変数が登録されている場合でも同様です。
この動作はデフォルトのファイルベースセッションハンドラとは異なるものです。
デフォルトのファイルベースセッションハンドラは空のセッションファイルを
生成します。
以下の例では、デフォルトの保存filesに似た
ファイルベースのセッション保存を行います。この例は、PHPがサポート
する任意のデータベースエンジンを用いてデータベースへの保存を行う
ように容易に拡張可能です。
saveハンドラが期待通りに動作するようにread関数は常に文字列を返す
必要があります。データがない場合には、空の文字列を返してください。
他のハンドラからの返り値は、論理式、すなわち、成功時にTRUE、失
敗した場合にFALSEを返します。
例 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(""); // Must return "" here. }
}
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)); }
/********************************************* * WARNING - You will need to implement some * * sort of garbage collection routine here. * *********************************************/ function gc ($maxlifetime) { return true; }
session_set_save_handler ("open", "close", "read", "write", "destroy", "gc");
session_start();
// proceed to use sessions normally
?>
|
|
session.save_handler
設定ディレクティブも参照してください。