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 設定ディレクティブも参照してください。