在Yii中有很多的路徑,在開發的過程當前我們也會使用一些路徑。一般來說都需要使用絕對路徑,但絕對路徑都很長。
所以,爲了方便的使用路徑,可以在Yi中i給每個路徑起個名稱,這個名稱就是別名。
別名的格式:
- 別名必須以“@”字符開頭,別名中還可以包含“/”。如("@www"爲根別名,"@www/test"就爲子別名)
- 別名最後的目錄分隔符(“\”或者“/”)都將去掉(如果有的情況下)
- 目錄路徑或者文件的路徑(`/tmp`, `/tmp/main.txt`)
- URL(`http://www.yii2.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");
如:別名@yii 對應的路徑爲/xxx/yii,那麼@yii/base將會解析爲/xxx/yii/base
獲取別名
獲取別名路徑的時候按如下順序來:- 如果別名不以"@"開頭,直接返回別名,不作處理
- 查找相匹配的最長的別名,然後用別名路徑來替換傳入的參數中的別名。
- 如果用@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
- 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;
- }
- }