检索可访问WordPress应用程序文件(例如wp-blog-header.php或wp-admin /文件夹)的给定站点的URL。
原型
get_site_url( int $blog_id = null, string $path = '', string $scheme = null )
描述
使用适当的协议返回’site_url’选项,如果是is_ssl()则返回’https’,否则返回’http’。如果$ scheme为’http’或’https’,则重写is_ssl()。
参数
$blog_id
(int)
(Optional)
网站ID。默认为null(当前站点)。
$path
(string)
(Optional)
相对于站点URL的路径。
$scheme
(string)
(Optional)
提供站点URL上下文的Scheme。接受’http’,‘https’,‘login’,‘login_post’,‘admin’或’relative’。
返回值
(string)
附加了可选路径的站点URL链接。
源文件
路径:wp-includes/link-template.php
<?php
...
function get_site_url( $blog_id = null, $path = '', $scheme = null ) {
if ( empty( $blog_id ) || !is_multisite() ) {
$url = get_option( 'siteurl' );
} else {
switch_to_blog( $blog_id );
$url = get_option( 'siteurl' );
restore_current_blog();
}
$url = set_url_scheme( $url, $scheme );
if ( $path && is_string( $path ) )
$url .= '/' . ltrim( $path, '/' );
/**
* Filters the site URL.
*
* @since 2.7.0
*
* @param string $url The complete site URL including scheme and path.
* @param string $path Path relative to the site URL. Blank string if no path is specified.
* @param string|null $scheme Scheme to give the site URL context. Accepts 'http', 'https', 'login',
* 'login_post', 'admin', 'relative' or null.
* @param int|null $blog_id Site ID, or null for the current site.
*/
return apply_filters( 'site_url', $url, $path, $scheme, $blog_id );
}
...
?>
其他
英文文档:https://developer.wordpress.org/reference/functions/get_site_url/