TP 学习之 session 方法的学习

最近公司项目也做的差不多了，终于有点时间来仔细研究一下Thinkphp 中的详细代码了，今天主要是看了一下TP session 方法的实现，然后就直接一边看，一边给代码一行行的加了注释！贴出来，自己记录一下，也供需要的人看一下！如果有注释的不对的地方，还请指出，共同学习！多谢多谢。。。注释中还有一些小知识点是我们需要知道的，这个也要注意呢！

<span style="font-size:18px;">/**
 * session管理函数
 * @param string|array $name session名称 如果为数组则表示进行session设置
 * @param mixed $value session值
 * @return mixed
 */
function session($name="",$value="") {
    // 取到 session 保存前缀
    $prefix   =  C("SESSION_PREFIX");
    
    // 如果传入的name 为一个数组，那么就是初始化session
    if(is_array($name)) { // session初始化 在session_start 之前调用
    
        // 如果配置中设置了 session 前缀属性， 则更改配置项中的session 前缀
        if(isset($name["prefix"])) C("SESSION_PREFIX",$name["prefix"]);
        
        // 如果 request 中的session_id 有值，则将session_id 设置成它（优先设置成request 中的）
        if(C("VAR_SESSION_ID") && isset($_REQUEST[C("VAR_SESSION_ID")])){
            session_id($_REQUEST[C("VAR_SESSION_ID")]);
            
            // 否则就将 session_id 设置成传进来的值
        }elseif(isset($name["id"])) {
            session_id($name["id"]);
        }
        
        // 如果应用模式为 common 则将session 变成不能自动启动
        if("common" == APP_MODE){ // 其它模式可能不支持
            ini_set("session.auto_start", 0); 
        }
        
        // 设置session 的name
        if(isset($name["name"]))            session_name($name["name"]);
        // 设置session 存储的路径
        if(isset($name["path"]))            session_save_path($name["path"]);
        // 设置domain
        if(isset($name["domain"]))          ini_set("session.cookie_domain", $name["domain"]);
        // 设置session 的存在时间
        if(isset($name["expire"]))          {
            ini_set("session.gc_maxlifetime",   $name["expire"]);
            ini_set("session.cookie_lifetime",  $name["expire"]);
        }
        
        // 设置当页session 到下一页是否能够使用（这是个学习的点）  ？？？session 在第二页不能使用了的原因以及解决办法？？？？
        // http://blog.163.com/freestyle_le/blog/static/1832794482012926725423/
        if(isset($name["use_trans_sid"]))   ini_set("session.use_trans_sid", $name["use_trans_sid"]?1:0);
        // 设置 session_id 在客户端采用的存储方式为cookie,只有这样$_COOKIE["PHPSESSIONID"] 才会存在
        if(isset($name["use_cookies"]))     ini_set("session.use_cookies", $name["use_cookies"]?1:0);
        // 指定回话页面所使用的缓存控制方法
        /**
        *  知识点:
        *  PHP中的 session_cache_limiter() 函数是指定会话页面所使用的缓冲控制方法。
        *   语法：
        *   string session_cache_limiter ( [string cache_limiter])
        *   cache_limiter 要设置的缓存限制的名字
        *   返回缓存限制的名字
        *    
        *   但是要值得注意的是session_cache_limiter()方法要写在session_start()方法之前才有用。
        *    
        *   实际应用：
        *    
        *   在开发过程中，往往因为表单出错而返回页面的时候填写的信息都不见了，为了支持页面回跳，可以通过两种方法实现。
        *    
        *   第一，使用Header方法设置消息头Cache-control
        *   header("Cache-control: private, must-revalidate");//支持页面回跳
        *    
        *   第二，使用session_cache_limiter方法
        *   //注意要写在session_start方法之前
        *   session_cache_limiter("private, must-revalidate");//支持页面回跳
        *
        */
        if(isset($name["cache_limiter"]))   session_cache_limiter($name["cache_limiter"]);
        
        // 设置session 缓存时间
        if(isset($name["cache_expire"]))    session_cache_expire($name["cache_expire"]);
        // 设置 session 存储方式  type: db file
        if(isset($name["type"]))            C("SESSION_TYPE",$name["type"]);
        
        if(C("SESSION_TYPE")) { // 读取session驱动
            $type   =   C("SESSION_TYPE");
            $class  =   strpos($type,"\")? $type : "Think\Session\Driver\". ucwords(strtolower($type));
            $hander =   new $class();
            
            // 这里有点不明白？？？？？？？？？？？？？？？  &  php 中的引用（貌似和c++似的）
            session_set_save_handler(
                array(&$hander,"open"), 
                array(&$hander,"close"), 
                array(&$hander,"read"), 
                array(&$hander,"write"), 
                array(&$hander,"destroy"), 
                array(&$hander,"gc")); 
        }
        // 启动session 如果设置了自动启动
        // 这是在配置好了以上配置之后才启动session  因为有些配置项需要在session 启动之前配置
        if(C("SESSION_AUTO_START"))  session_start();
        
        
    }elseif("" === $value){ 
        if(""===$name){   // 如果value 值恒等于空则判断 name的值是否为空,如果不为空则代表获取全部的session 
            // 获取全部的session
            return $prefix ? $_SESSION[$prefix] : $_SESSION;
            
            // 下面几个同级if 如果想要看懂，先看下手册这里:
            //  http://document.thinkphp.cn/manual_3_2.html#session
        }elseif(0===strpos($name,"[")) { // session 操作
            if("[pause]"==$name){ // 暂停session
                session_write_close();
            }elseif("[start]"==$name){ // 启动session
                session_start();
            }elseif("[destroy]"==$name){ // 销毁session
                $_SESSION =  array();
                session_unset();
                session_destroy();
            }elseif("[regenerate]"==$name){ // 重新生成id
                session_regenerate_id();
            }
        }elseif(0===strpos($name,"?")){ // 检查session
            $name   =  substr($name,1);
            if(strpos($name,".")){ // 支持数组
                list($name1,$name2) =   explode(".",$name);
                return $prefix?isset($_SESSION[$prefix][$name1][$name2]):isset($_SESSION[$name1][$name2]);
            }else{
                return $prefix?isset($_SESSION[$prefix][$name]):isset($_SESSION[$name]);
            }
            
            // 如果传入的name = NULL || "" || 等等
        }elseif(is_null($name)){ // 清空session
            if($prefix) {
                unset($_SESSION[$prefix]);
            }else{
                $_SESSION = array();
            }
            
            
        }elseif($prefix){ // 获取session
            if(strpos($name,".")){
                list($name1,$name2) =   explode(".",$name);
                return isset($_SESSION[$prefix][$name1][$name2])?$_SESSION[$prefix][$name1][$name2]:null;  
            }else{
                return isset($_SESSION[$prefix][$name])?$_SESSION[$prefix][$name]:null;                
            }            
        }else{
            // 不存在前缀，则根据 传入的name 获取
            if(strpos($name,".")){  // 二维数组情况
                list($name1,$name2) =   explode(".",$name);
                return isset($_SESSION[$name1][$name2])?$_SESSION[$name1][$name2]:null;  
            }else{ // 一位数组情况
                return isset($_SESSION[$name])?$_SESSION[$name]:null;
            }            
        }
        
        // 如果值为空,名字不为空，则清空对应的值
    }elseif(is_null($value)){ // 删除session
        if(strpos($name,".")){
            list($name1,$name2) =   explode(".",$name);
            if($prefix){
                unset($_SESSION[$prefix][$name1][$name2]);
            }else{
                unset($_SESSION[$name1][$name2]);
            }
        }else{
            if($prefix){
                unset($_SESSION[$prefix][$name]);
            }else{
                unset($_SESSION[$name]);
            }
        }
        
    // 值也不为空  名字既不为空也不为数组    绑定键值
    }else{ // 设置session
		if(strpos($name,".")){
			list($name1,$name2) =   explode(".",$name);
			if($prefix){
				$_SESSION[$prefix][$name1][$name2]   =  $value;
			}else{
				$_SESSION[$name1][$name2]  =  $value;
			}
		}else{
			if($prefix){
				$_SESSION[$prefix][$name]   =  $value;
			}else{
				$_SESSION[$name]  =  $value;
			}
		}
    }
    return null;
}</span>