WordPress开发：home_url与site_url函数用法详解

一、获取首页链接：home_url()

第1步：理解 home_url() 的功能与入口

home_url() 是 WordPress 中用于获取“站点URL”（即用户访问网站时看到的首页地址）的核心函数。无论 WordPress 安装在根目录还是子目录，该函数始终指向配置中的站点地址（Site Address (URL)），通常也就是前端展示的域名。
此函数定义位于 wp-includes/link-template.php 文件中。

第2步：掌握 home_url() 的参数设置

函数调用格式为：home_url( $path, $scheme )，主要包含两个可选参数：

• $path（字符串，可选）：需要附加在首页URL后的相对路径。如果不传参，则返回裸域名或带斜杠的首页地址。
• $scheme（字符串，可选）：指定链接使用的协议。仅支持三种值：
  • http：强制使用 HTTP 协议。
  • https：强制使用 HTTPS 协议。
  • relative：生成相对于当前域名的路径（不含域名）。适用于同一域名下的内部资源引用。

第3步：查看 home_url() 的返回结果

函数最终返回一个字符串，内容为首页基础URL拼接上$path后的完整链接。

第4步：运行 home_url() 的代码示例

假设你的站点设置为 http://www.example.com，以下示例演示了不同参数的输出效果：

// 默认输出（通常为 http 或 https，取决于站点设置）
echo home_url(); 
// 输出示例: http://www.example.com

// 追加相对路径 '/'
echo home_url( '/' );
// 输出示例: http://www.example.com/

// 强制使用 https 协议并追加路径
echo home_url( '/', 'https' );
// 输出示例: https://www.example.com/

// 使用 relative 方案（常用于加载同域下的JS/CSS）
echo home_url( 'example', 'relative' );
// 输出示例: /example

二、获取站点安装路径：site_url()

第5步：理解 site_url() 的功能与入口

site_url() 用于获取 WordPress 系统的实际安装位置URL（WordPress Address (URL)）。

第6步：掌握 site_url() 的参数设置

函数调用格式为：site_url( $path, $scheme )，参数含义与 home_url() 类似，但 $scheme 的选项更为丰富：

• $path（字符串，可选）：附加在安装路径后的内容。
• $scheme（字符串，可选）：除了 http、https 和 relative 外，还支持以下特殊语义：
  • login：生成的链接会自动添加 /wp-login.php 后缀。
  • admin：生成的链接会自动添加 /wp-admin/ 后缀。

第7步：查看 site_url() 的返回结果

返回值为：WordPress安装基础URL + $path 参数形成的完整字符串。

第8步：运行 site_url() 的代码示例

假设你的 WordPress 安装在 http://www.example.com/wordpress 子目录下：

// 获取完整的安装路径
echo site_url(); 
// 输出示例: http://www.example.com/wordpress

// 强制使用 https 并追加自定义路径
echo site_url( '/secrets/', 'https' );
// 输出示例: https://www.example.com/wordpress/secrets/

三、关键差异总结

1. 用途不同：使用 home_url() 引用对外展示的内容（如 logo、首页链接）；使用 site_url() 引用系统内部文件（如 wp-content/plugins, wp-login.php）。
2. 子目录环境：当 WP 安装在非根目录时，两者路径前缀不一致，切勿混用以免 404 错误。
3. 安全性：推荐在引入后台管理页面或登录接口时，显式指定 https scheme 以确保安全连接。

以上就是WordPress中home_url和site_url函数的详细内容，更多关于WordPress开发的资料请关注本站其它相关文章！