当前位置:首页 > PHP教程 > PHP常见问题

详解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 助手类:yiihelpersurl
  • 使用内置的 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管理器,使用 yiihelpersurl 助手类可大大简化 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]);
    
    

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


    【说明】本文章由站长整理发布,文章内容不代表本站观点,如文中有侵权行为,请与本站客服联系(QQ:254677821)!