Yii2中设置与获取别名的函数(setAlias和getAlias)用法

Yii::setAlias("@", "C:\\");
Yii::setAlias("@data", "C:\\data");
Yii::setAlias("@data/attach", "C:\\data\attach\icon.png");
Yii::setAlias("@home", ".yiifans.\");
Yii::setAlias("@admin", "@\admin");

Yii::getAlias("@");
//输出C:\
Yii::getAlias("@data");
//输出C:\\data
Yii::getAlias("@data/attach");
//输出C:\\data\attach\icon.png
Yii::getAlias("@home");
//输出.yiifans.
Yii::getAlias("@admin");
//输出C:\\admin

public static function setAlias($alias, $path)
{
 if (strncmp($alias, '@', 1)) {
  //如果不是@开头，则自动在前面加上@
  $alias = '@' . $alias;
 }
 //查找别名中的"/"
 $pos = strpos($alias, '/');
 //如果别名中没有"/"，则根别名就是所输入的别名，否则从截取"/"前面的作为根别名
 //如@，根别名就为@；
 //如:@/data，那么根别名截取为@。
 $root = $pos === false ? $alias : substr($alias, 0, $pos);
 if ($path !== null) {
  /
    如果路径中包含有别名，另直接调用getAlias来解析得到路径。
    否则去掉结尾的"/"、"\"
   /
  $path = strncmp($path, '@', 1) ? rtrim($path, '\\/') : static::getAlias($path);
  if (!isset(static::$aliases[$root])) {
   /
     如果还没有设置过这个根别名（@）
    
     如果别名就是根别名（参数就是@），则直接设置别名对应的路径（['@'=>'路径']）
     否则生成路径为一个数组(['@'=>['@/data'=>'路径'])
    
     @   ['@'=>'xxxx']
     @/a   ['@'=>['@/a'=>xxxa]]
     @/b   ['@'=>['@/b'=>xxxb]]
     @/a/b   ['@'=>['@/a/b'=>xxxc]]
    
     注上面的这4中只会注册其中的一个，因为在上面判断了有没有注册@
    /
   if ($pos === false) {
    static::$aliases[$root] = $path;
   } else {
    static::$aliases[$root] = [$alias => $path];
   }
  } elseif (is_string(static::$aliases[$root])) {
   /
     注册过根别名（只有注册过根别名，对应的值才会是字符串）
    
     如果当前注册的是根别名，直接覆盖旧值。
     ['@']=xxx
    
     否则把当前别名和根别名添加到根别名数组中
     @/a  ['@']=['@/a'=>xxxa,'@'=>'xxx']
    
    /
   if ($pos === false) {
    static::$aliases[$root] = $path;
   } else {
    static::$aliases[$root] = [
     $alias => $path,
     $root => static::$aliases[$root],
    ];
   }
  } else {
   //添加到根别名的数组中
   static::$aliases[$root][$alias] = $path;
   krsort(static::$aliases[$root]);
  }
 } elseif (isset(static::$aliases[$root])) {
  //如果是根别名数组，删除子别名。
  if (is_array(static::$aliases[$root])) {
   unset(static::$aliases[$root][$alias]);
  } elseif ($pos === false) {
   //删除整个根别名数组
   unset(static::$aliases[$root]);
  }
 }
}

public static function getAlias($alias, $throwException = true)
{
 //如果不是为@开头，直接返回alias
 if (strncmp($alias, '@', 1)) {
  // not an alias
  return $alias;
 }
 //获取根别名，和setAlias相同
 $pos = strpos($alias, '/');
 $root = $pos === false ? $alias : substr($alias, 0, $pos);
 if (isset(static::$aliases[$root])) {
  //如果根别名的值为字符串，即只设置了一个根别名（['@'=>xxx]）
  if (is_string(static::$aliases[$root])) {
   /
     如果获取的名称为根别名，直接返回根别名对应的路径，
     否则返回值为根别名路径+去掉别名之后的路径
    
     如
     @,直接返回 xxx
     @/aaa/bbb 返回xxx/aaa/bbb
    /
   return $pos === false ? static::$aliases[$root] : static::$aliases[$root] . substr($alias, $pos);
  } else {
   / 遍历子别名
    
     @=>xxx  ['@']=xxx
     @=>yyy  ['@']=yyy
     @/a=>yyya  ['@']=['@/a'=>yyya,'@'=>yyy]
     @/b=>yyyb  ['@']=['@/a'=>yyya,'@/b'=>yyyb,'@'=>yyy]
     @/a/c=>yyyac  ['@']=['@/a/c'=>yyyac,'@/a'=>yyya,'@/b'=>yyyb,'@'=>yyy]
    /
   foreach (static::$aliases[$root] as $name => $path) {
    /
      在这里，因为根别名的所有子别名都根据键也就是子别名进行了逆向排序
      所以在查找的时候总是先匹配最长的别名。
     
      又因为在比较的时候给别名后面加了"/"，所以可以保证在查找的时候能以"/"作为分隔符。
     /
    if (strpos($alias . '/', $name . '/') === 0) {
     return $path . substr($alias, strlen($name));
    }
   }
  }
 }
 if ($throwException) {
  throw new InvalidParamException("Invalid path alias: $alias");
 } else {
  return false;
 }
}