详解Yii2 之 生成 URL 的方法


Posted in PHP onJune 16, 2017

前言

在项目中,推荐使用 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 生成工具

  1. URL 管理器:urlManager
  2. URL 助手类:yii\helpers\Url

使用内置的 URL 生成工具,以后可以在不改变源码的情况通过配置即可美化整站的 URL

URL 管理器

URL 管理器是一个名叫 urlManager 的内置应用组件。在 WEB 应用和控制台应用中以通过以下两种方式创建 URL:

  1. \Yii::$app->urlManager->createUrl($params)
  2. \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
echo Url::to();

// 创建当前 URL
// 显示:http://www.example.com/?r=kernel/article/view&id=10
echo Url::to('', true);

// 字符参数,没啥用
// 显示:kernel/article/view
echo Url::to('kernel/article/view');

// 创建路由,数组参数的自动调用 Url::toRoute(...)
// 显示:/index.php?r=kernel/article/view
echo Url::to(['article/view']);

2. 假设当前 URL /index.php?r=kernel/article/view&id=10,以下说明 URL 助手类 Url::toRoute() 方法是如何工作的(推荐):

// 创建当前路由(仅继承参数r的值)
// 显示:/index.php?r=kernel/article/view
echo Url::toRoute([]);

// 相同的模块和控制器,不同的动作(仅继承参数r的值)
// 显示:/index.php?r=kernel/article/list
echo Url::toRoute('list');

// 相同的模块和控制器,不同的动作(仅继承参数r的值)
// 显示:/index.php?r=kernel/article/list&cat=contact
echo Url::toRoute(['list','cat'=>10]);

// 相同模块,不同控制器和动作(仅继承参数r的值)
// 显示:/index.php?r=kernel/product/index
echo Url::toRoute('product/index');

// 绝对路由,不管是被哪个模块和控制器调用
// 显示:/index.php?r=product/index
echo Url::toRoute('/product/index');

// 控制器动作 `actionListHot` 的 URL 格式(仅继承参数r的值,区分大小写)
// 显示:/index.php?r=kernel/article/list-hot
echo Url::toRoute('list-hot');

// 从别名中获取 URL 
// 显示:http://www.baidu.com/
Yii::setAlias('@baidu', 'http://www.baidu.com/');
echo Url::to('@baidu');

3. 假设当前 URL /index.php?r=kernel/article/view&id=10,以下说明 URL 助手类 Url::current() 方法是如何工作的(推荐):

// 创建当前 URL(包括路由和参数)
// 显示:/?r=kernel/article/view&id=10
echo Url::current();

// 移除参数 id
// 显示:/?r=kernel/article/view
echo Url::current(['id'=>null]);

// 新增参数 cat
// 显示:/?r=kernel/article/view&id=10&cat=2
echo Url::current(['cat'=>2]);

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

PHP 相关文章推荐
PHP iconv 函数转gb2312的bug解决方法
Oct 11 PHP
选择PHP作为网站开发语言的原因分享
Jan 03 PHP
Zend的MVC机制使用分析(一)
May 02 PHP
PHP return语句的另一个作用
Jul 30 PHP
WordPress导航菜单的滚动和淡入淡出效果的实现要点
Dec 14 PHP
PHP实现查询两个数组中不同元素的方法
Feb 23 PHP
PHP数组编码gbk与utf8互相转换的两种方法
Sep 01 PHP
php组合排序简单实现方法
Oct 15 PHP
php的laravel框架快速集成微信登录的方法
Dec 12 PHP
php删除数组指定元素实现代码
May 03 PHP
PHP实现将多个文件中的内容合并为新文件的方法示例
Jun 10 PHP
PHP实现APP微信支付的实例讲解
Feb 10 PHP
PHP+Mysql+Ajax实现淘宝客服或阿里旺旺聊天功能(前台页面)
Jun 16 #PHP
php使用str_replace替换多维数组的实现方法分析
Jun 15 #PHP
php读取出一个文件夹及其子文件夹下所有文件的方法示例
Jun 15 #PHP
php7基于递归实现删除空文件夹的方法示例
Jun 15 #PHP
php实现的二叉树遍历算法示例
Jun 15 #PHP
深入浅析PHP的session反序列化漏洞问题
Jun 15 #PHP
PHP中phar包的使用教程
Jun 14 #PHP
You might like
PHP递归返回值时出现的问题解决办法
2013/02/19 PHP
自己写的php curl库实现整站克隆功能
2015/02/12 PHP
PHP的数组中提高元素查找与元素去重的效率的技巧解析
2016/03/03 PHP
PHP用户验证和标签推荐的简单使用
2016/10/31 PHP
解析 thinkphp 框架中的部分方法
2017/05/07 PHP
Laravel 模型使用软删除-左连接查询-表起别名示例
2019/10/24 PHP
javascript下高性能字符串连接StringBuffer类
2010/08/16 Javascript
Extjs中ComboBox加载并赋初值的实现方法
2012/03/22 Javascript
js 数组操作之pop,push,unshift,splice,shift
2014/01/29 Javascript
JavaScript获取function所有参数名的方法
2015/10/30 Javascript
Vue实现virtual-dom的原理简析
2017/07/10 Javascript
Vue2.0用 watch 观察 prop 变化(不触发)
2017/09/08 Javascript
实现div滚动条默认最底部以及默认最右边的示例代码
2017/11/15 Javascript
jQuery实现轮播图及其原理详解
2020/04/12 jQuery
详解Vue项目中出现Loading chunk {n} failed问题的解决方法
2018/09/14 Javascript
对angular 实时更新模板视图的方法$apply详解
2018/10/09 Javascript
vue通过指令(directives)实现点击空白处收起下拉框
2018/12/06 Javascript
node.js命令行教程图文详解
2019/05/27 Javascript
JavaScript Window窗口对象属性和使用方法
2020/01/19 Javascript
不要用强制方法杀掉python线程
2017/02/26 Python
对Python 3.5拼接列表的新语法详解
2018/11/08 Python
django正续或者倒序查库实例
2020/05/19 Python
python 基于opencv实现图像增强
2020/12/23 Python
美国购买汽车零件网站:Buy Auto Parts
2018/04/02 全球购物
英国领先的在线旅游和休闲零售商:lastminute.com
2019/01/23 全球购物
新员工培训个人的自我评价
2013/10/09 职场文书
人力资源作业细则
2014/03/03 职场文书
高一新生军训方案
2014/05/12 职场文书
我的大学四年规划书范文2014
2014/09/26 职场文书
2014年机关作风建设工作总结
2014/10/23 职场文书
2015年计生工作总结范文
2015/04/24 职场文书
与死神共舞观后感
2015/06/15 职场文书
2015年公路路政个人工作总结
2015/07/24 职场文书
2016年端午节红领巾广播稿
2015/12/18 职场文书
MySQL创建索引需要了解的
2021/04/08 MySQL
如何给HttpServletRequest增加消息头
2021/06/30 Java/Android