get_home_url
函数
get_home_url ( $blog_id = null, $path = '', $scheme = null )
- 参数
-
-
(int|null)
$blog_id
Optional. Site ID. Default null (current site).- Required: 否
- Default: null
-
(string)
$path
Optional. Path relative to the home URL. Default empty.- Required: 否
- Default: (empty)
-
(string|null)
$scheme
Optional. Scheme to give the home URL context. Accepts ‘http’, ‘https’, ‘relative’, ‘rest’, or null. Default null.- Required: 否
- Default: null
-
(int|null)
- 返回值
-
- (string) Home URL link with optional path appended.
- 定义位置
-
-
wp-includes/link-template.php
, line 3338
-
wp-includes/link-template.php
- 引入
- 3.0.0
- 弃用
- –
Retrieves the URL for a given site where the front end is accessible.
Returns the ‘home’ option with the appropriate protocol. The protocol will be ‘https’
if is_ssl() evaluates to true; otherwise, it will be the same as the ‘home’ option.
If `$scheme` is ‘http’ or ‘https’, is_ssl() is overridden.
function get_home_url( $blog_id = null, $path = '', $scheme = null ) { $orig_scheme = $scheme; if ( empty( $blog_id ) || ! is_multisite() ) { $url = get_option( 'home' ); } else { switch_to_blog( $blog_id ); $url = get_option( 'home' ); restore_current_blog(); } if ( ! in_array( $scheme, array( 'http', 'https', 'relative' ), true ) ) { if ( is_ssl() ) { $scheme = 'https'; } else { $scheme = parse_url( $url, PHP_URL_SCHEME ); } } $url = set_url_scheme( $url, $scheme ); if ( $path && is_string( $path ) ) { $url .= '/' . ltrim( $path, '/' ); } /** * Filters the home URL. * * @since 3.0.0 * * @param string $url The complete home URL including scheme and path. * @param string $path Path relative to the home URL. Blank string if no path is specified. * @param string|null $orig_scheme Scheme to give the home URL context. Accepts 'http', 'https', * 'relative', 'rest', or null. * @param int|null $blog_id Site ID, or null for the current site. */ return apply_filters( 'home_url', $url, $path, $orig_scheme, $blog_id ); }
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。