wp_internal_hosts(): string[]
Returns an array of URL hosts which are considered to be internal hosts.
Contents
Description
By default the list of internal hosts is comprised of the host name of the site’s home_url() (as parsed by wp_parse_url() ).
This list is used when determining if a specificed URL is a link to a page on the site itself or a link offsite (to an external host). This is used, for example, when determining if the "nofollow" attribute should be applied to a link.
See also
Return
string[] An array of URL hosts.
Source
File: wp-includes/link-template.php
.
View all references
function wp_internal_hosts() {
static $internal_hosts;
if ( empty( $internal_hosts ) ) {
/**
* Filters the array of URL hosts which are considered internal.
*
* @since 6.2.0
*
* @param string[] $internal_hosts An array of internal URL hostnames.
*/
$internal_hosts = apply_filters(
'wp_internal_hosts',
array(
wp_parse_url( home_url(), PHP_URL_HOST ),
)
);
$internal_hosts = array_unique(
array_map( 'strtolower', (array) $internal_hosts )
);
}
return $internal_hosts;
}
Hooks
-
apply_filters( 'wp_internal_hosts',
string[] $internal_hosts ) -
Filters the array of URL hosts which are considered internal.
Changelog
Version | Description |
---|---|
6.2.0 | Introduced. |