ThinkPHP中Common/common.php文件常用函數(shù)功能分析

字號(hào):


    本文實(shí)例分析了ThinkPHP/Common/common.php文件常用函數(shù)功能。分享給大家供大家參考,具體如下:
    /**
     * 獲取和設(shè)置配置參數(shù) 支持批量定義
     * @param string|array $name 配置變量
     * @param mixed $value 配置值
     * @return mixed
     */
    function C($name=null, $value=null) {
      static $_config = array();
      // 無(wú)參數(shù)時(shí)獲取所有
      if (empty($name)) {
        if(!empty($value) && $array = cache('c_'.$value)) {
          //array_change_key_case():將數(shù)組中的所有鍵名改為全小寫(xiě)或大寫(xiě),默認(rèn)會(huì)改為全小寫(xiě)
          $_config = array_merge($_config, array_change_key_case($array));
        }
        return $_config;
      }
      // 優(yōu)先執(zhí)行設(shè)置獲取或賦值,如果參數(shù)2為空,則為獲取配置配置變量的值的情況;如果參數(shù)2不為空,則是為配置變量設(shè)置值的情況
      if (is_string($name)) {//給配置變量設(shè)置值或者獲取配置變量的值
        if (!strpos($name, '.')) {//如果配置變量名中沒(méi)有".",則執(zhí)行下面代碼
          $name = strtolower($name);//將配置變量名轉(zhuǎn)化為小寫(xiě)
          if (is_null($value))
            return isset($_config[$name]) ? $_config[$name] : null;//獲取配置變量值的情況,返回配置變量的值
          $_config[$name] = $value;//給配置變量設(shè)置值的情況
          return;
        }
        // 二維數(shù)組設(shè)置和獲取支持
        $name = explode('.', $name);
        $name[0]  = strtolower($name[0]);
        if (is_null($value))
          return isset($_config[$name[0]][$name[1]]) ? $_config[$name[0]][$name[1]] : null;//獲取值的情況
        $_config[$name[0]][$name[1]] = $value;//賦值的情況
        return;
      }
      // 批量設(shè)置
      if (is_array($name)){//批量設(shè)置值
        //array_change_key_case():將數(shù)組中的所有鍵名改為全小寫(xiě)或大寫(xiě),默認(rèn)會(huì)改為全小寫(xiě),注意:只是將鍵名改為小寫(xiě)哦
        $_config = array_merge($_config, array_change_key_case($name));
        if(!empty($value)) {// 保存配置值
          cache('c_'.$value,$_config);
        }
        return;
      }
      return null; // 避免非法參數(shù)
    }
    -------------------------------------------------------------------------------------------------------------------
    /**
     * 處理標(biāo)簽擴(kuò)展,如: 項(xiàng)目開(kāi)始標(biāo)簽的調(diào)用,tag('app_begin');
     * @param string $tag 標(biāo)簽名稱(chēng)
     * @param mixed $params 傳入?yún)?shù)
     * @return mixed
     */
    function tag($tag, &$params=NULL) {
      // 系統(tǒng)或框架標(biāo)簽擴(kuò)展
      // C('extends', include THINK_PATH.'Conf/tags.php');//這個(gè)文件很重要
      $extends  = C('extends.' . $tag);//$_config['extends'][app_init]
      // 應(yīng)用或項(xiàng)目標(biāo)簽擴(kuò)展
      // C('tags', include CONF_PATH.'tags.php'); //項(xiàng)目中也可以編寫(xiě)自己的tags.php文件
      $tags    = C('tags.' . $tag);//$_config['tags'][app_init]
      if (!empty($tags)) {//如果$tags不為空
        if(empty($tags['_overlay']) && !empty($extends)) { // 合并擴(kuò)展
          $tags = array_unique(array_merge($extends,$tags));
        }elseif(isset($tags['_overlay'])){ // 通過(guò)設(shè)置 '_overlay'=>1 覆蓋系統(tǒng)標(biāo)簽
          unset($tags['_overlay']);
        }
      }elseif(!empty($extends)) {
        $tags = $extends;
      }
      if($tags) {
        if(APP_DEBUG) {
          G($tag.'Start');
          trace('[ '.$tag.' ] --START--','','INFO');
        }
        // 執(zhí)行擴(kuò)展
        foreach ($tags as $key=>$name) {
          if(!is_int($key)) { // 指定行為類(lèi)的完整路徑 用于模式擴(kuò)展
            $name  = $key;
          }
          //創(chuàng)建行為類(lèi)對(duì)象,如:$class=$name.'Behavior';$behavior  = new $class();//創(chuàng)建一個(gè)行為類(lèi)對(duì)象
          B($name, $params);//執(zhí)行某個(gè)行為,參數(shù)1-行為名稱(chēng)  參數(shù)2-傳入的參數(shù)
        }
        if(APP_DEBUG) { // 記錄行為的執(zhí)行日志
          trace('[ '.$tag.' ] --END-- [ RunTime:'.G($tag.'Start',$tag.'End',6).'s ]','','INFO');
        }
      }else{ // 未執(zhí)行任何行為 返回false
        return false;
      }
    }
    --------------------------------------------------------------------------------------------------------------------------
    /**
     * 執(zhí)行某個(gè)行為
     * @param string $name 行為名稱(chēng)
     * @param Mixed $params 傳人的參數(shù)
     * @return void
     */
    function B($name, &$params=NULL) {
      //行為類(lèi)在Think.class.php文件中的autoload($class)函數(shù)中自動(dòng)加載
      $class   = $name.'Behavior';//行為類(lèi)的名稱(chēng)
      G('behaviorStart');
      $behavior  = new $class();//創(chuàng)建一個(gè)行為類(lèi)對(duì)象
      $behavior->run($params);//給當(dāng)前行為類(lèi)對(duì)象傳遞參數(shù)
      if(APP_DEBUG) { // 記錄行為的執(zhí)行日志
        trace('Run '.$name.' Behavior [ RunTime:'.G('behaviorStart','behaviorEnd',6).'s ]','','INFO');
      }
    }
    注意:行為類(lèi)、模型類(lèi)、控制器類(lèi) 都是在Think.class.php文件中的autoload函數(shù)中自動(dòng)加載的:
    /**
    * 系統(tǒng)自動(dòng)加載ThinkPHP類(lèi)庫(kù)
    * 并且支持配置自動(dòng)加載路徑
    * @param string $class 對(duì)象類(lèi)名
    * @return void
    */
    //行為類(lèi)、模型類(lèi)、控制器類(lèi) 都是通過(guò)autoload函數(shù)自動(dòng)加載的
    public static function autoload($class) {
        // 檢查是否存在別名定義
        if(alias_import($class)) return ;
        //行為類(lèi)都是通過(guò)此函數(shù)自動(dòng)加載的
        if(substr($class,-8)=='Behavior') { // 加載行為
          if(require_cache(CORE_PATH.'Behavior/'.$class.'.class.php')
            || require_cache(EXTEND_PATH.'Behavior/'.$class.'.class.php')
            || require_cache(LIB_PATH.'Behavior/'.$class.'.class.php')
            || (defined('MODE_NAME') && require_cache(MODE_PATH.ucwords(MODE_NAME).'/Behavior/'.$class.'.class.php'))) {
            return ;
          }
        }elseif(substr($class,-5)=='Model'){ // 加載模型
          if((defined('GROUP_NAME') && require_cache(LIB_PATH.'Model/'.GROUP_NAME.'/'.$class.'.class.php'))
            || require_cache(LIB_PATH.'Model/'.$class.'.class.php')
            || require_cache(EXTEND_PATH.'Model/'.$class.'.class.php') ) {
            return ;
          }
        }elseif(substr($class,-6)=='Action'){ // 加載控制器
          if((defined('GROUP_NAME') && require_cache(LIB_PATH.'Action/'.GROUP_NAME.'/'.$class.'.class.php'))
            || require_cache(LIB_PATH.'Action/'.$class.'.class.php')
            || require_cache(EXTEND_PATH.'Action/'.$class.'.class.php') ) {
            return ;
          }
        }
        // 根據(jù)自動(dòng)加載路徑設(shè)置進(jìn)行嘗試搜索
        $paths =  explode(',',C('APP_AUTOLOAD_PATH'));
        foreach ($paths as $path){
          if(import($path.'.'.$class))
            // 如果加載類(lèi)成功則返回
            return ;
        }
    }
    希望本文所述對(duì)大家基于ThinkPHP框架的PHP程序設(shè)計(jì)有所幫助。