关于session的几个补充函数

以下为引用的内容：
在PHP下，关于session的讨论很多，其实在PHP4中还有几个函数是我们平时没有注意到的。 下面我把它们介绍给大家吧。

其中的session_set_save_handler()可真是个好东西。

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

session_unset (PHP4 >= 4.0b4)

void session_unset(void);

这个函数可以把当然注册的所有的session变量置为空。注意它不是unregister，也不同于destroy。

下面这个例子，对此函数做了很好的说明。

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 "B:$b - reg:".session_is_registered('b')."

"; // the registration remains !

echo "C:$c - 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

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

# 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

";

?>

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