当前浏览:首页 / WordPress函数 / home_url()

home_url( string $path = '', string|null $scheme = null )

检索可访问前端的当前站点的URL

home

urlmore...


描述

返回具有适当协议的“home”选项。如果is_ssl()计算结果为true,则协议将为“https”;否则,它将与“home”选项相同。如果$scheme是“http”或“https”,则覆盖is_ssl()


参数

$path

(string)(可选) 相对于主页URL的路径。

默认值: ''

$scheme

(string|null)(可选) 给出主页URL上下文的方案。接受'http'、'https'、'relative'、'rest'或null。

默认值: null


返回

(string) 附加了可选路径的主页URL链接。



源码

查看源码 官方文档


更新日志

版本描述
3.0.0开始引入

使用示例

  • 示例1

    实例

    $url = home_url();
    echo $url;
    

    输出:http://www.example.com

    (注意缺少尾部斜杠)

    $url = home_url( '/' );
    echo $url;
    

    输出:http://www.example.com/

    $url = home_url( $path = '/', $scheme = 'https' );
    echo $url;
    

    输出:https://www.example.com/

    $url = home_url( $path = 'example', $scheme = 'relative' );
    echo $url;
    

    输出:/example

  • 示例2

    您还可以在`$path`的末尾添加属性…

    $url = esc_url(home_url( '/my-page?id=123'));
    echo $url;
    
    // https://your-domain/my-page?id=123
    

    但是最好使用esc_url()来确保获得一个干净的url