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

Сигнатура

wp_is_local_html_output( string $html ): bool|null

Описание

Эта функция пытается проверить наличие в HTML-строке различных типичных для WordPress паттернов.
Поскольку любое из этих действий может быть отключено сторонним кодом, функция также может вернуть null, указывая на то, что определить принадлежность не удалось.

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

This function attempts to check for various common WordPress patterns whether they are included in the HTML string.
Since any of these actions may be disabled through third-party code, this function may also return null to indicate that it was not possible to determine ownership.

Параметры

$html string обязательный

Полная строка HTML-вывода, например из HTTP-ответа.

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

bool|null

Исходный код

wp-includes/https-detection.php:173

function wp_is_local_html_output( $html ) {
	// 1. Check if HTML includes the site's Really Simple Discovery link.
	if ( has_action( 'wp_head', 'rsd_link' ) ) {
		$pattern = preg_replace( '#^https?:(?=//)#', '', esc_url( site_url( 'xmlrpc.php?rsd', 'rpc' ) ) ); // See rsd_link().
		return str_contains( $html, $pattern );
	}

	// 2. Check if HTML includes the site's REST API link.
	if ( has_action( 'wp_head', 'rest_output_link_wp_head' ) ) {
		// Try both HTTPS and HTTP since the URL depends on context.
		$pattern = preg_replace( '#^https?:(?=//)#', '', esc_url( get_rest_url() ) ); // See rest_output_link_wp_head().
		return str_contains( $html, $pattern );
	}

	// Otherwise the result cannot be determined.
	return null;
}

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

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