Yii2.0源码分析之——设置别名函数(setAlias)和获取别名函数(getAlias)

首先说说什么是别名。

在Yii中有很多的路径,在开发的过程当前我们也会使用一些路径。一般来说都需要使用绝对路径,但绝对路径都很长。
所以,为了方便的使用路径,可以在Yi中i给每个路径起个名称,这个名称就是别名。

别名的格式:

  • 别名必须以“@”字符开头,别名中还可以包含“/”。如("@www"为根别名,"@www/test"就为子别名)

  • 别名最后的目录分隔符(“\”或者“/”)都将去掉(如果有的情况下)

别名的路径有以下几个格式

    • 目录路径或者文件的路径(`/tmp`, `/tmp/main.txt`)

    • URL(`http://www.yiifans.com`)

    • 另一个别名路径(`@yii/base`),这样会调用getAlias(),解析里面的别名。

设置别名

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

设置别名的时候,如果路径里面包含别名那么会调用getAlias(),解析里面的别名。
如:别名@yii 对应的路径为/xxx/yii,那么@yii/base将会解析为/xxx/yii/base

获取别名
获取别名路径的时候按如下顺序来:

  • 如果别名不以"@"开头,直接返回别名,不作处理

  • 查找相匹配的最长的别名,然后用别名路径来替换传入的参数中的别名。

如设置了两个别名“@foo”=>"my"和“@foo/test”=>"my/test"。

  • 如果用@foo/test/config来获取对应的路径,结果为"my/test/config"

  • 如果用@foo/testtst/config来获取对应的路径,结果为"my/testtst/config"

  • 如果用@foo/config来获取对应的路径,结果为"my/config"

即在匹配的时候会以“/”作为分隔符,先匹配最长的别名。

上面设置的别名的结果分别为:


Yii::getAlias("@www");
//输出:C:\www

Yii::getAlias("@data");
//输出:C:\www\data

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

Yii::getAlias("@home");
//输出:www.yiifans.com

Yii::getAlias("@admin");
//输出:C:\www\admin

设置别名函数源码:setAlias


public static function setAlias($alias, $path)
{
if (strncmp($alias, ‘@‘, 1)) {
//如果不是@开头,则自动在前面加上@
$alias = ‘@‘ . $alias;
}
//查找别名中的“/”
$pos = strpos($alias, ‘/‘);
//如果别名中没有“/”,则根别名就是所输入的别名,否则从截取“/”前面的作为根别名
//如:@www,根别名就为@www;
//如:@www/data,那么根别名截取为@www。
$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])) {
/*
* 如果还没有设置过这个根别名(@www)
*
* 如果别名就是根别名(参数就是@www),则直接设置别名对应的路径([‘@www‘=>‘路径‘])
* 否则生成路径为一个数组([‘@www‘=>[‘@www/data‘=>‘路径‘])
*
* @www [‘@www‘=>‘xxxx‘]
* @www/a [‘@www‘=>[‘@www/a‘=>xxxa]]
* @www/b [‘@www‘=>[‘@www/b‘=>xxxb]]
* @www/a/b [‘@www‘=>[‘@www/a/b‘=>xxxc]]
*
* 注:上面的这4中只会注册其中的一个,因为在上面判断了有没有注册@www
*/
if ($pos === false) {
static::$aliases[$root] = $path;
} else {
static::$aliases[$root] = [$alias => $path];
}
} elseif (is_string(static::$aliases[$root])) {
/*
* 注册过根别名(只有注册过根别名,对应的值才会是字符串)
*
* 如果当前注册的是根别名,直接覆盖旧值。
* [‘@www‘]=xxx
*
* 否则把当前别名和根别名添加到根别名数组中
* @www/a [‘@www‘]=[‘@www/a‘=>xxxa,‘@www‘=>‘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]);
}
}
}

例如:

  • @www=>xxx             
      [‘@www‘]=xxx

  • @www=>yyy             
      [‘@www‘]=yyy

  • @www/a=>yyya       
       [‘@www‘]=[‘@www/a‘=>yyya,‘@www‘=>yyy]

  • @www/b=yyyb            
    [‘@www‘]=[‘@www/a‘=>yyya,‘@www‘=>yyy,‘@www/b‘=>yyyb]

也就是说,会把所有的相同根别名的数据,放到一个以根别名为键的数组中,而且对键进行逆向排序

获取别名函数源码:getAlias


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])) {
//如果根别名的值为字符串,即只设置了一个根别名([‘@www‘=>xxx])
if (is_string(static::$aliases[$root])) {
/*
* 如果获取的名称为根别名,直接返回根别名对应的路径,
* 否则返回值为根别名路径+去掉别名之后的路径
*
* 如:
* @www,直接返回 xxx
* @www/aaa/bbb 返回xxx/aaa/bbb
*/
return $pos === false ? static::$aliases[$root] : static::$aliases[$root] . substr($alias, $pos);
} else {

/* 遍历子别名
*
* @www=>xxx [‘@www‘]=xxx
* @www=>yyy [‘@www‘]=yyy
* @www/a=>yyya [‘@www‘]=[‘@www/a‘=>yyya,‘@www‘=>yyy]
* @www/b=>yyyb [‘@www‘]=[‘@www/a‘=>yyya,‘@www/b‘=>yyyb,‘@www‘=>yyy]
* @www/a/c=>yyyac [‘@www‘]=[‘@www/a/c‘=>yyyac,‘@www/a‘=>yyya,‘@www/b‘=>yyyb,‘@www‘=>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;
}
}

原文连接:http://www.yiifans.com/forum.php?mod=viewthread&tid=42

Yii2.0源码分析之——设置别名函数(setAlias)和获取别名函数(getAlias),布布扣,bubuko.com

时间: 2024-10-24 17:55:46

Yii2.0源码分析之——设置别名函数(setAlias)和获取别名函数(getAlias)的相关文章

HBase1.0.0源码分析之请求处理流程分析以Put操作为例(二)

HBase1.0.0源码分析之请求处理流程分析以Put操作为例(二) 1.通过mutate(put)操作,将单个put操作添加到缓冲操作中,这些缓冲操作其实就是Put的父类的一个List的集合.如下: private List<Row> writeAsyncBuffer = new LinkedList<>(); writeAsyncBuffer.add(m); 当writeAsyncBuffer满了之后或者是人为的调用backgroundFlushCommits操作促使缓冲池中的

Solr4.8.0源码分析(10)之Lucene的索引文件(3)

Solr4.8.0源码分析(10)之Lucene的索引文件(3) 1. .si文件 .si文件存储了段的元数据,主要涉及SegmentInfoFormat.java和Segmentinfo.java这两个文件.由于本文介绍的Solr4.8.0,所以对应的是SegmentInfoFormat的子类Lucene46SegmentInfoFormat. 首先来看下.si文件的格式 头部(header) 版本(SegVersion) doc个数(SegSize) 是否符合文档格式(IsCompoundF

Solr4.8.0源码分析(17)之SolrCloud索引深入(4)

Solr4.8.0源码分析(17)之SolrCloud索引深入(4) 前面几节以add为例已经介绍了solrcloud索引链建索引的三步过程,delete以及deletebyquery跟add过程大同小异,这里暂时就不介绍了.由于commit流程较为特殊,那么本节主要简要介绍下commit的流程. 1. SolrCloud的commit流程 SolrCloud的commit流程同样分为三步,本节主要简单介绍下三步过程. 1.1 LogUpdateProcessor LogUpdateProces

Solr4.8.0源码分析(11)之Lucene的索引文件(4)

Solr4.8.0源码分析(11)之Lucene的索引文件(4) 1. .dvd和.dvm文件 .dvm是存放了DocValue域的元数据,比如DocValue偏移量. .dvd则存放了DocValue的数据. 在Solr4.8.0中,dvd以及dvm用到的Lucene编码格式是Lucene45DocValuesFormat.跟之前的文件格式类似,它分别包含Lucene45DocValuesProducer 和Lucene45DocValuesConsumer来实现该文件的读和写. 1 @Ove

Solr4.8.0源码分析(5)之查询流程分析总述

Solr4.8.0源码分析(5)之查询流程分析总述 前面已经写到,solr查询是通过http发送命令,solr servlet接受并进行处理.所以solr的查询流程从SolrDispatchsFilter的dofilter开始.dofilter包含了对http的各个请求的操作.Solr的查询方式有很多,比如q,fq等,本章只关注select和q.页面下发的查询请求如下:http://localhost:8080/solr/test/select?q=code%3A%E8%BE%BD*+AND+l

Solr4.8.0源码分析(23)之SolrCloud的Recovery策略(四)

Solr4.8.0源码分析(23)之SolrCloud的Recovery策略(四) 题记:本来计划的SolrCloud的Recovery策略的文章是3篇的,但是没想到Recovery的内容蛮多的,前面三章分别介绍了Recovery的原理和总体流程,PeerSync策略,Replication策略.本章主要介绍我在实际生产环境中碰到的recovery的几个问题,以及前面漏下的几个点. 一. 日志中多次出现"Stopping recovery for zkNodeName= ..." 我在

Solr4.8.0源码分析(20)之SolrCloud的Recovery策略(一)

Solr4.8.0源码分析(20)之SolrCloud的Recovery策略(一) 题记: 我们在使用SolrCloud中会经常发现会有备份的shard出现状态Recoverying,这就表明SolrCloud的数据存在着不一致性,需要进行Recovery,这个时候的SolrCloud建索引是不会写入索引文件中的(每个shard接受到update后写入自己的ulog中).关于Recovery的内容包含三篇,本文是第一篇介绍Recovery的原因以及总体流程. 1. Recovery的起因 Rec

Solr4.8.0源码分析(13)之LuceneCore的索引修复

Solr4.8.0源码分析(13)之LuceneCore的索引修复 题记:今天在公司研究elasticsearch,突然看到一篇博客说elasticsearch具有索引修复功能,顿感好奇,于是点进去看了下,发现原来是Lucene Core自带的功能,于是就回家先学习下,正好也跟之前看的索引文件的格式相应.有空也研究下Lucene的一些小工具. 索引的修复主要是用到CheckIndex.java这个类,可以直接查看类的Main函数来了解下. 1. CheckIndex的使用 首先使用以下命令来查看

Solr4.8.0源码分析(9)之Lucene的索引文件(2)

Solr4.8.0源码分析(9)之Lucene的索引文件(2) 一. Segments_N文件 一个索引对应一个目录,索引文件都存放在目录里面.Solr的索引文件存放在Solr/Home下的core/data/index目录中,一个core对应一个索引. Segments_N例举了索引所有有效的segments信息以及删除的具体信息,一个索引可以有多个Segments_N,但是有效的往往总是N最大的那个,为什么会出现多个segments_N,主要是由于暂时无法删除它们或者有indexwriter