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

本文實例分析了ThinkPHP/Common/common.php文件常用函數功能。分享給大家供大家參考，具體如下：

/**
 * 獲取和設置配置參數 支持批量定義
 * @param string|array $name 配置變量
 * @param mixed $value 配置值
 * @return mixed
 */
function C($name=null, $value=null) {
  static $_config = array();
  // 無參數時獲取所有
  if (empty($name)) {
    if(!empty($value) && $array = cache('c_'.$value)) {
      //array_change_key_case()：將數組中的所有鍵名改為全小寫或大寫，默認會改為全小寫
      $_config = array_merge($_config, array_change_key_case($array));
    }
    return $_config;
  }
  // 優先執行設置獲取或賦值，如果參數2為空，則為獲取配置配置變量的值的情況；如果參數2不為空，則是為配置變量設置值的情況
  if (is_string($name)) {//給配置變量設置值或者獲取配置變量的值
    if (!strpos($name, '.')) {//如果配置變量名中沒有".",則執行下面代碼
      $name = strtolower($name);//將配置變量名轉化為小寫
      if (is_null($value))
        return isset($_config[$name]) ? $_config[$name] : null;//獲取配置變量值的情況，返回配置變量的值
      $_config[$name] = $value;//給配置變量設置值的情況
      return;
    }
    // 二維數組設置和獲取支持
    $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;
  }
  // 批量設置
  if (is_array($name)){//批量設置值
    //array_change_key_case()：將數組中的所有鍵名改為全小寫或大寫，默認會改為全小寫，注意：只是將鍵名改為小寫哦
    $_config = array_merge($_config, array_change_key_case($name));
    if(!empty($value)) {// 保存配置值
      cache('c_'.$value,$_config);
    }
    return;
  }
  return null; // 避免非法參數
}

/**
 * 處理標簽擴展，如： 項目開始標簽的調用，tag('app_begin');
 * @param string $tag 標簽名稱
 * @param mixed $params 傳入參數
 * @return mixed
 */
function tag($tag, &$params=NULL) {
  // 系統或框架標簽擴展
  // C('extends', include THINK_PATH.'Conf/tags.php');//這個文件很重要
  $extends  = C('extends.' . $tag);//$_config['extends'][app_init]
  // 應用或項目標簽擴展
  // C('tags', include CONF_PATH.'tags.php'); //項目中也可以編寫自己的tags.php文件
  $tags    = C('tags.' . $tag);//$_config['tags'][app_init]
  if (!empty($tags)) {//如果$tags不為空
    if(empty($tags['_overlay']) && !empty($extends)) { // 合並擴展
      $tags = array_unique(array_merge($extends,$tags));
    }elseif(isset($tags['_overlay'])){ // 通過設置 '_overlay'=>1 覆蓋系統標簽
      unset($tags['_overlay']);
    }
  }elseif(!empty($extends)) {
    $tags = $extends;
  }
  if($tags) {
    if(APP_DEBUG) {
      G($tag.'Start');
      trace('[ '.$tag.' ] --START--','','INFO');
    }
    // 執行擴展
    foreach ($tags as $key=>$name) {
      if(!is_int($key)) { // 指定行為類的完整路徑 用於模式擴展
        $name  = $key;
      }
      //創建行為類對象，如：$class=$name.'Behavior';$behavior  = new $class();//創建一個行為類對象
      B($name, $params);//執行某個行為,參數1-行為名稱  參數2-傳入的參數
    }
    if(APP_DEBUG) { // 記錄行為的執行日志
      trace('[ '.$tag.' ] --END-- [ RunTime:'.G($tag.'Start',$tag.'End',6).'s ]','','INFO');
    }
  }else{ // 未執行任何行為 返回false
    return false;
  }
}

/**
 * 執行某個行為
 * @param string $name 行為名稱
 * @param Mixed $params 傳人的參數
 * @return void
 */
function B($name, &$params=NULL) {
  //行為類在Think.class.php文件中的autoload($class)函數中自動加載
  $class   = $name.'Behavior';//行為類的名稱
  G('behaviorStart');
  $behavior  = new $class();//創建一個行為類對象
  $behavior->run($params);//給當前行為類對象傳遞參數
  if(APP_DEBUG) { // 記錄行為的執行日志
    trace('Run '.$name.' Behavior [ RunTime:'.G('behaviorStart','behaviorEnd',6).'s ]','','INFO');
  }
}

注意：行為類、模型類、控制器類 都是在Think.class.php文件中的autoload函數中自動加載的:

/**
* 系統自動加載ThinkPHP類庫
* 並且支持配置自動加載路徑
* @param string $class 對象類名
* @return void
*/
//行為類、模型類、控制器類 都是通過autoload函數自動加載的
public static function autoload($class) {
    // 檢查是否存在別名定義
    if(alias_import($class)) return ;
    //行為類都是通過此函數自動加載的
    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 ;
      }
    }
    // 根據自動加載路徑設置進行嘗試搜索
    $paths =  explode(',',C('APP_AUTOLOAD_PATH'));
    foreach ($paths as $path){
      if(import($path.'.'.$class))
        // 如果加載類成功則返回
        return ;
    }
}

PS：這裡推薦幾款本站的格式化/美化/轉換工具可以幫助你整理雜亂無章的代碼，相信大家在以後的開發中能夠用得上：

php代碼在線格式化美化工具：
http://tools.jb51.net/code/phpformat

JavaScript代碼美化/壓縮/格式化/加密工具：
http://tools.jb51.net/code/jscompress

在線XML格式化/壓縮工具：
http://tools.jb51.net/code/xmlformat

JSON代碼格式化美化工具：
http://tools.jb51.net/code/json

在線XML/JSON互相轉換工具：
http://tools.jb51.net/code/xmljson

json代碼在線格式化/美化/壓縮/編輯/轉換工具：
http://tools.jb51.net/code/jsoncodeformat

sql代碼在線格式化美化工具：
http://tools.jb51.net/code/sqlcodeformat

更多關於thinkPHP相關內容感興趣的讀者可查看本站專題：《ThinkPHP入門教程》、《ThinkPHP常用方法總結》、《PHP中cookie用法總結》、《smarty模板入門基礎教程》及《PHP模板技術總結》。

希望本文所述對大家基於ThinkPHP框架的PHP程序設計有所幫助。