Avril Note

在PHP下，關於session的討論很多，其實在PHP4中還有幾個函數是我們平時沒有注意到的。

下面我把它們介紹給大家吧。

其中的session_set_save_handler()可真是個好東西。

//********************
session_unset (PHP4 >= 4.0b4)

void session_unset(void);

這個函數可以把當然註冊的所有的session變量置為空。注意它不是unregister，也不同於destroy。

下面這個例子，對此函數做了很好的說明。

<?php

session_register('a','b','c'); //auto-session-start
$a=1;
$b=2;
$c=3;
session_unregister('a'); //unregistrered $a
echo "A: $a - reg:".session_is_registered('a')."
"; // but the global $a remains
session_unset(); // unsets $b und $c
echo "Bb - reg:".session_is_registered('b')."
"; // the registration remains !
echo "Cc - reg:".session_is_registered('c')."
";
echo session_encode();
?>

輸出：
A: 1 - reg:
B: - reg:1
C: - reg:1
!b|!c|

//********************************
session_get_cookie_params (PHP4 >= 4.0RC2)

array session_get_cookie_params (void);

返回一個數組，記錄了當前session的cookie的一些信息。
有：

"lifetime" - cookie的生存期。

"path" - cookie的保存路徑。

"domain" - cookie的域。

//*******************************
session_set_cookie_params (PHP4 >= 4.0b4)

void session_set_cookie_params (int lifetime [, string path [, string domain]])

設置session的cookie的一些參參數，類似於php.ini中的設置，但本函數所作的設置，只對當前腳本文件有效。

//*******************************

下面要介紹的這個函數應是對大家都很有用的，你是不是對自定義一個不用cookie來保存的session有興趣呢？這個函數就可以實現你這樣的設想。

讓我想想，如果不用cookie的好處是什麼？至少一點，你不用擔心客戶端的的cookie的功能是否打開了，對吧。

session_set_save_handler (PHP4 >= 4.0b4)

void session_set_save_handler (string open, string close, string read, string write, string destroy, string gc)

這個函數可以定義用戶級的session的保存函數（打開、關閉、寫入等）。
比如，我們想把session保存在本地的一個數據庫中時，本函數就很有用了。

！！！注意：使用本函數前，先要配置php.ini文件，session.save_hadler=user ，否則，session_set_save_handler()不會生效。

此外，根據我的測試，你如果想讓這樣的session跨頁面使用，還要在每一個用到session的腳本文件中加入你自定的函數及 session_set_save_handler，所以，最好的方法是做成一個單獨的文件，在每一個要用到session的腳本中用include來包含進來。

下面這個例子提供了一個最基本的session保存法，類似於默認的files方法。
如果你想用數據庫來實現，這也是很容易做到的。

Example 1. session_set_save_handler() example

<?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));
}

/*********************************************
* 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了。

?>

//***************************************

session_cache_limiter (PHP4 CVS only)

string session_cache_limiter ([string cache_limiter])

本函數可以設置或取得session.cache_limiter的值。
在php.ini中也可以做同樣的設置。其值有 nocache,public,private。

本函數是通過HTTP的header發送到客戶端的。如果為nocache，將禁止任何客戶端的cache。而public將允許cache，但是private相對public而言，更為安全一點。

缺省值是在php.ini中的設置，如果你要使用它，必須在每次調用session_start()之前調用本函數。

此函數現在只能在CVS模式下運行，但是PHP4.0.3將支持它。

Example 1. session_cache_limiter() examples

<?php

# set the cache limiter to 'private'

session_cache_limiter('private);
$cache_limiter = session_cache_limiter();

echo "The cache limiter is now set to $cache_limiter<p>";
?>

//*****************************