函数文档

wp_favicon_request()

💡 云策文档标注

概述

wp_favicon_request() 函数用于处理 favicon.ico 请求,避免加载完整的 WordPress 环境,直接发送零长度图标响应并退出。

关键要点

  • 函数检查请求 URI 是否为 '/favicon.ico',如果是则设置 Content-Type 为 'image/vnd.microsoft.icon' 并退出执行。
  • 该函数自 WordPress 5.4.0 起已弃用,建议使用 do_favicon() 替代。
  • 最初在 WordPress 3.0.0 版本中引入。

代码示例

function wp_favicon_request() {
    if ( '/favicon.ico' === $_SERVER['REQUEST_URI'] ) {
        header( 'Content-Type: image/vnd.microsoft.icon' );
        exit;
    }
}

注意事项

  • 此函数已弃用,开发者应迁移到 do_favicon() 以处理 favicon 请求。
  • 确保在 favicon.ico 请求时避免不必要的 WordPress 加载,提升性能。

📄 原文内容

Ensures all of WordPress is not loaded when handling a favicon.ico request.

Description

Instead, send the headers for a zero-length favicon and bail.

Source

function wp_favicon_request() {
	if ( '/favicon.ico' === $_SERVER['REQUEST_URI'] ) {
		header( 'Content-Type: image/vnd.microsoft.icon' );
		exit;
	}
}

Changelog

Version Description
5.4.0 Deprecated. Deprecated in favor of do_favicon() .
3.0.0 Introduced.