is_favicon() │ WP 5.4.0

Проверяет, является ли текущий запрос запросом на favicon.ico файл.

Эта функция по умолчанию вызывается при подключении страницы шаблона сайта в файле wp-includes/template-loader.php

Функция сработает, когда запрашивается URL /favicon.ico

Обычно это происходит автоматически при загрузке сайта, чтобы отобразить иконку вкладки:

• Обычный визит пользователя на сайт — браузер сам делает запрос к /favicon.ico.
• Бот (например, поисковик) индексирует сайт и запрашивает иконку.
• Прямая ссылка типа https://example.com/favicon.ico.

Функция может не сработать, если:

• Favicon запрашивается по другому пути (например, задан в метатеге <link rel="icon" href="https://example.com/custom-icon.ico">).
• Запрос проходит мимо WordPress — например, если сервер (Nginx/Apache) отдает favicon.ico напрямую, минуя index.php.
• Используется кэш на уровне сервера (Nginx, Varnish, ...), и favicon отдается без участия WP.
• WP установлен в подкаталоге, а favicon запрашивается по корню (/favicon.ico), где нет ВП.

• Используется отдельный домен или CDN для статики, и иконка грузится оттуда.

• Инициализации WP перехватывается например, через auto_prepend_file — это директива PHP, которая позволяет подключить файл до выполнения любого другого PHP-кода.

  Пример в php.ini или .htaccess:

  php_value auto_prepend_file /path/to/file.php

  Если в этом файле стоит следующее условие, то WP вообще не загрузится при запросе к /favicon.ico:

  if ( $_SERVER['REQUEST_URI'] === '/favicon.ico' ) {
  	readfile( '/path/to/favicon.ico' );
  	exit;
  }

Хуков нет.

Возвращает

true|false. Запрашивается ли файл favicon.ico.

Использование

if( is_favicon() ){
	// do staff
}

Примеры

add_action( 'do_favicon', 'get_simple_favicon' );

function get_simple_favicon() {

	header( 'Content-Type: image/x-icon' );

	$size = 16;
	$img  = imagecreatetruecolor( $size, $size );

	$white = imagecolorallocate( $img, 255, 255, 255 );
	$black = imagecolorallocate( $img, 0, 0, 0 );

	// Рисуем простой шахматный узор
	for ( $y = 0; $y < $size; $y++ ) {
		for ( $x = 0; $x < $size; $x++ ) {
			$color = ( ( $x + $y ) % 2 === 0 ) ? $black : $white;
			imagesetpixel( $img, $x, $y, $color );
		}
	}

	// Сохраняем картику .ico в переменную
	ob_start();
	imagepng( $img );
	imagedestroy( $img );
	$png_data = ob_get_clean();

	// Выводим на экран (преобразуем PNG в ICO через header)
	echo $png_data;

	exit;
}

if ( is_favicon() ) {
	error_log( 'Favicon requested: ' . $_SERVER['REMOTE_ADDR'] );
}

Добавить свой пример