详解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 生成工具

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]);

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。