关于ThinkPHP中Common/common.php文件常用函数的功能分析-php教程-PHP中文网

这篇文章主要介绍了ThinkPHP中Common/common.php文件常用函数功能,通过注释的形式详细分析了C方法、tag方法、B方法及autoload方法的功能与代码原理,需要的朋友可以参考下

本文实例分析了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(&#39;c_&#39;.$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, &#39;.&#39;)) {//如果配置变量名中没有".",则执行下面代码
      $name = strtolower($name);//将配置变量名转化为小写
      if (is_null($value))
        return isset($_config[$name]) ? $_config[$name] : null;//获取配置变量值的情况，返回配置变量的值
      $_config[$name] = $value;//给配置变量设置值的情况
      return;
    }
    // 二维数组设置和获取支持
    $name = explode(&#39;.&#39;, $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(&#39;c_&#39;.$value,$_config);
    }
    return;
  }
  return null; // 避免非法参数
}

登录后复制

/**
 * 处理标签扩展，如： 项目开始标签的调用，tag(&#39;app_begin&#39;);
 * @param string $tag 标签名称
 * @param mixed $params 传入参数
 * @return mixed
 */
function tag($tag, &$params=NULL) {
  // 系统或框架标签扩展
  // C(&#39;extends&#39;, include THINK_PATH.&#39;Conf/tags.php&#39;);//这个文件很重要
  $extends  = C(&#39;extends.&#39; . $tag);//$_config[&#39;extends&#39;][app_init]
  // 应用或项目标签扩展
  // C(&#39;tags&#39;, include CONF_PATH.&#39;tags.php&#39;); //项目中也可以编写自己的tags.php文件
  $tags    = C(&#39;tags.&#39; . $tag);//$_config[&#39;tags&#39;][app_init]
  if (!empty($tags)) {//如果$tags不为空
    if(empty($tags[&#39;_overlay&#39;]) && !empty($extends)) { // 合并扩展
      $tags = array_unique(array_merge($extends,$tags));
    }elseif(isset($tags[&#39;_overlay&#39;])){ // 通过设置 &#39;_overlay&#39;=>1 覆盖系统标签
      unset($tags[&#39;_overlay&#39;]);
    }
  }elseif(!empty($extends)) {
    $tags = $extends;
  }
  if($tags) {
    if(APP_DEBUG) {
      G($tag.&#39;Start&#39;);
      trace(&#39;[ &#39;.$tag.&#39; ] --START--&#39;,&#39;&#39;,&#39;INFO&#39;);
    }
    // 执行扩展
    foreach ($tags as $key=>$name) {
      if(!is_int($key)) { // 指定行为类的完整路径 用于模式扩展
        $name  = $key;
      }
      //创建行为类对象，如：$class=$name.&#39;Behavior&#39;;$behavior  = new $class();//创建一个行为类对象
      B($name, $params);//执行某个行为,参数1-行为名称  参数2-传入的参数
    }
    if(APP_DEBUG) { // 记录行为的执行日志
      trace(&#39;[ &#39;.$tag.&#39; ] --END-- [ RunTime:&#39;.G($tag.&#39;Start&#39;,$tag.&#39;End&#39;,6).&#39;s ]&#39;,&#39;&#39;,&#39;INFO&#39;);
    }
  }else{ // 未执行任何行为 返回false
    return false;
  }
}

登录后复制

/**
 * 执行某个行为
 * @param string $name 行为名称
 * @param Mixed $params 传人的参数
 * @return void
 */
function B($name, &$params=NULL) {
  //行为类在Think.class.php文件中的autoload($class)函数中自动加载
  $class   = $name.&#39;Behavior&#39;;//行为类的名称
  G(&#39;behaviorStart&#39;);
  $behavior  = new $class();//创建一个行为类对象
  $behavior->run($params);//给当前行为类对象传递参数
  if(APP_DEBUG) { // 记录行为的执行日志
    trace(&#39;Run &#39;.$name.&#39; Behavior [ RunTime:&#39;.G(&#39;behaviorStart&#39;,&#39;behaviorEnd&#39;,6).&#39;s ]&#39;,&#39;&#39;,&#39;INFO&#39;);
  }
}

登录后复制

注意：行为类、模型类、控制器类都是在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)==&#39;Behavior&#39;) { // 加载行为
      if(require_cache(CORE_PATH.&#39;Behavior/&#39;.$class.&#39;.class.php&#39;)
        || require_cache(EXTEND_PATH.&#39;Behavior/&#39;.$class.&#39;.class.php&#39;)
        || require_cache(LIB_PATH.&#39;Behavior/&#39;.$class.&#39;.class.php&#39;)
        || (defined(&#39;MODE_NAME&#39;) && require_cache(MODE_PATH.ucwords(MODE_NAME).&#39;/Behavior/&#39;.$class.&#39;.class.php&#39;))) {
        return ;
      }
    }elseif(substr($class,-5)==&#39;Model&#39;){ // 加载模型
      if((defined(&#39;GROUP_NAME&#39;) && require_cache(LIB_PATH.&#39;Model/&#39;.GROUP_NAME.&#39;/&#39;.$class.&#39;.class.php&#39;))
        || require_cache(LIB_PATH.&#39;Model/&#39;.$class.&#39;.class.php&#39;)
        || require_cache(EXTEND_PATH.&#39;Model/&#39;.$class.&#39;.class.php&#39;) ) {
        return ;
      }
    }elseif(substr($class,-6)==&#39;Action&#39;){ // 加载控制器
      if((defined(&#39;GROUP_NAME&#39;) && require_cache(LIB_PATH.&#39;Action/&#39;.GROUP_NAME.&#39;/&#39;.$class.&#39;.class.php&#39;))
        || require_cache(LIB_PATH.&#39;Action/&#39;.$class.&#39;.class.php&#39;)
        || require_cache(EXTEND_PATH.&#39;Action/&#39;.$class.&#39;.class.php&#39;) ) {
        return ;
      }
    }
    // 根据自动加载路径设置进行尝试搜索
    $paths =  explode(&#39;,&#39;,C(&#39;APP_AUTOLOAD_PATH&#39;));
    foreach ($paths as $path){
      if(import($path.&#39;.&#39;.$class))
        // 如果加载类成功则返回
        return ;
    }
}

登录后复制

以上就是本文的全部内容，希望对大家的学习有所帮助，更多相关内容请关注PHP中文网！