Yii2之Url类全面解密 有你不知道的~

Url

以前开发项目的时候,我们习惯于把网站网址做一个配置参数保存,善于用yii2的Url各种方法,无形中让你的代码更简单、更灵活、更规范。
下面就一一说明一下。

Url::base($scheme = false)

base函数返回当前请求的基地址,它有一个参数$scheme,默认为false,代表返回地址不包含主机信息。
$scheme参数说明

  • false 返回地址不包含主机信息

  • true 包含主机地址

  • http 返回http协议的主机地址

  • https 返回https协议的主机地址

  • '' 返回相对的主机地址

我们以http://yii2-study.local.com/i... 来举例

Url::base();
    //  返回为''
    Url::base(true)
    //  返回为http://yii2-study.local.com
    //  记住:最后没有反斜杠哦
    Url::base('http');
    //  返回为http://yii2-study.local.com
    Url::base('https');
    //  返回为https://yii2-study.local.com
    Url::base('');
    //  返回为//yii2-study.local.com

切记:http https ''这些参数,函数base并没有去判断,只是简单的字符串替换,如果你输入了base('d'),则返回

d://yii2-study.local.com

Url::canonical()

返回当前请求的标准url
我们还是以http://yii2-study.local.com/i... 来举例

echo Url::canonical();
    //  返回结果为 http://yii2-study.local.com/index.php?r=site/index

Url::current(array $params = [], $scheme = false)

返回当前请求+GET参数,重点是该函数配合参数还能增加删除GET参数,这在我们某些url匹配时候会变得非常有用。
我们以http://yii2-study.local.com/i... 来举例

echo Url::current();

执行上述代码后我们会得到 /index.php?r=site/index&id=78&cat=me 这样的结果

请注意,current()和canonical()区别,如果对本例里的url执行canonical()函数,会得到http://yii2-study.local.com/i... ,相比较current,它多了主机信息,少了GET参数(路由请求除外)。

上面是current获取当前的Url,我们还可以使用current对请求进行修改和删除等操作。

例子1:我们对当前请求增加一个name=abei GET参数,只需要执行

echo Url::current(['name'=>'abei']);

于是我们获得了预想的结果/index.php?r=site/index&id=78&cat=me&name=abei

例子2:我们要删除例子url中的cat参数,只需要执行

echo Url::current(['cat'=>null]);

则结果为/index.php?r=site/index&id=78 哈哈,cat参数被删除了

千万记住:删除一个GET参数的时候,只能设置current对应参数值为null,设置成false或''都是没用的。

例子3:更新例子中url的cat参数为you

echo Url::current(['cat'=>'you']);

是的,yii2很贴心的将将结果返回为 /index.php?r=site/index&id=78&cat=you。感谢薛强,虽然现在在yii2的github已经看不到你的comment,仍然要感谢你创造了yii2.

一个大问题,current返回的结果中如何包含主机信息那?
你只需,只需将current的第二个参数设置为true就ok了。

Url::to($url = '', $scheme = false) 和 Url::toRoute($route, $scheme = false)

生成一个URL,to()和toRoute()只有一个不同,那就是当to()的第一个函数为一个字符串的时候,会直接返回,而toRoute会将其解析成controller/action或action,然后返回url。
下面我们来举几个例子来说明下

Url::to(['site/about','cat'=>'abei']);
    Url::toRoute(['site/about','cat'=>'abei']);
    //  以上两个函数输出了同一个结果 index.php?r=site/about&cat=abei
    Url::to('site/index');
    Url::toRoute('site/index');
    //  以上两个函数输出结果不同 to()的结果为site/index toRoute()的结果为index.php?r=site/index
    Url::to();
    Url::toRoute();
    //  to()无参数时返回了当前的路由+GET,而toRoute报错了(toRoute第一个参数不允许不存在)
    Url::to("@web/images/logo.gif");
    Url::toRoute("@web/images/logo.gif");
    //  to和toRoute均支持别名。
    Url::to(['site/index','#'=>'name');
    Url::toRoute(['site/index','#'=>'name')
    //  这里有一个特殊的#,使用他能实现内部锚点,to和toRoute均可以生成index.php?r=site/index#name

当然,to和toRoute也有第二个参数,决定返回的url是否含有主机信息。

哥俩好~ Url::previous($name = null)和Url::remember($url = '', $name = null)

你是否有过这样的需求,比如记录一个会员最近30个访问的路径,使用previous和remember就能轻易实现,就和他们的名字一样,用remember可以存储当前路径,使用previous可以把remember存起来的url展示出来。
来来来,贴代码,其他都没有用。

Url::remember('http://www.a.com','a');
    Url::remember('http://www.b.com','b');
    var_dump(Url::previous('a'));
    //  结果输出了http://www.a.com

yii2记住了,小提示,是session原理。

我想细心的你一定发现了,是的,previous和remember的参数是可以为空的,没错,阿北用代码来说明。
我们还是以 http://yii2-study.local.com/i...为例

echo Url::previous();
    //  当previous参数为空时,返回returnUrl。
    echo Url::remember();
    //  对于remember函数,当第一个参数$url不提供,将记住当前路由请求(即http://yii2-study.local.com/index.php?r=site/index),第二个参数$name不提供,则默认为yii\web\User::$returnUrlParam

其他!

当然Url还有一些其他函数,比如home()等,比较简单,就不一一说明,主要上面几个大方法掌握了,Url基本就过了。

相关推荐