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