详解Yii2 之 生成 URL 的方法
前言
在项目中,推荐使用Yii2内置的URL工具类生成链接,这样可以非常便捷的管理整站的URL行为:比如通过修改配置改变整站的URL格式等。URL更多高级的用法参见官方文档,这篇文章仅仅介绍Yii2生成URL的几种方式。
Yii2默认的URL链接格式
Yii2默认的URL链接格式是指为开启URL美化时的格式。
未启用子模块的URL格式:
//参数r中的article表示控制器,view表示动作 http://www.example.com/index.php?r=article/view&id=100
启用了子模块的URL格式:
//参数r中的kernel表示子模块 http://www.example.com/index.php?r=kernel/article/view&id=100
Yii2内置的URL生成工具
- URL管理器:urlManager
- URL助手类:yii\helpers\Url
使用内置的URL生成工具,以后可以在不改变源码的情况通过配置即可美化整站的URL
URL管理器
URL管理器是一个名叫urlManager的内置应用组件。在WEB应用和控制台应用中以通过以下两种方式创建URL:
- \Yii::$app->urlManager->createUrl($params)
- \Yii::$app->urlManager->createAbsoluteUrl($params,$schema=null)
createUrl方法生成根目录的相对路径,例如:/index.php?r=article/view
createAbsoluteUrl()方法生成的是绝对路径,例如:http://www.example.com/index.php?r=article/view
常见的利用URL管理器创建URL的例子:
//URL:/index.php?r=article/view \Yii::$app->urlManager->createUrl('article/view'); //URL:/index.php?r=article/view&id=2 \Yii::$app->urlManager->createUrl(['article/view','id'=>2]); //URL:http://www.example.com?r=kernel/article/view echo\Yii::$app->urlManager->createAbsoluteUrl('kernel/article/view');
URL助手类
相对于URL管理器,使用yii\helpers\Url助手类可大大简化URL的创建。
1.假设当前URL/index.php?r=kernel/article/view&id=10,以下说明URL助手类Url::to()是如何工作的(不推荐):
//创建当前URL //显示:/?r=kernel/article/view&id=10 echoUrl::to(); //创建当前URL //显示:http://www.example.com/?r=kernel/article/view&id=10 echoUrl::to('',true); //字符参数,没啥用 //显示:kernel/article/view echoUrl::to('kernel/article/view'); //创建路由,数组参数的自动调用Url::toRoute(...) //显示:/index.php?r=kernel/article/view echoUrl::to(['article/view']);
2.假设当前URL/index.php?r=kernel/article/view&id=10,以下说明URL助手类Url::toRoute()方法是如何工作的(推荐):
//创建当前路由(仅继承参数r的值) //显示:/index.php?r=kernel/article/view echoUrl::toRoute([]); //相同的模块和控制器,不同的动作(仅继承参数r的值) //显示:/index.php?r=kernel/article/list echoUrl::toRoute('list'); //相同的模块和控制器,不同的动作(仅继承参数r的值) //显示:/index.php?r=kernel/article/list&cat=contact echoUrl::toRoute(['list','cat'=>10]); //相同模块,不同控制器和动作(仅继承参数r的值) //显示:/index.php?r=kernel/product/index echoUrl::toRoute('product/index'); //绝对路由,不管是被哪个模块和控制器调用 //显示:/index.php?r=product/index echoUrl::toRoute('/product/index'); //控制器动作`actionListHot`的URL格式(仅继承参数r的值,区分大小写) //显示:/index.php?r=kernel/article/list-hot echoUrl::toRoute('list-hot'); //从别名中获取URL //显示:http://www.baidu.com/ Yii::setAlias('@baidu','http://www.baidu.com/'); echoUrl::to('@baidu');
3.假设当前URL/index.php?r=kernel/article/view&id=10,以下说明URL助手类Url::current()方法是如何工作的(推荐):
//创建当前URL(包括路由和参数) //显示:/?r=kernel/article/view&id=10 echoUrl::current(); //移除参数id //显示:/?r=kernel/article/view echoUrl::current(['id'=>null]); //新增参数cat //显示:/?r=kernel/article/view&id=10&cat=2 echoUrl::current(['cat'=>2]);
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持毛票票。