wp_internal_hosts() — описание функции WordPress на русском

Сигнатура

wp_internal_hosts(): string[]

Описание

По умолчанию список внутренних хостов состоит из имени хоста home_url() сайта (в том виде, в каком его разбирает wp_parse_url() ).
Этот список используется, чтобы определить, ведёт ли указанный URL на страницу самого сайта или на внешний ресурс (на сторонний хост). Это применяется, например, при определении того, нужно ли добавлять к ссылке атрибут «nofollow».
См. также wp_is_internal_link

Оригинал (английский)

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 specified 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.

Возвращаемое значение

string[]

Исходный код

wp-includes/link-template.php:4863

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;
}

История изменений

Версия	Описание
6.2.0	Introduced.