wp_internal_hosts(): string[]

Returns an array of URL hosts which are considered to be internal hosts.

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

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

VersionDescription
6.2.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.