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>