如何在PHP中检测HEAD请求并停止额外代码执行？

算力阿峰

2026-6-17

在PHP中检测HEAD请求并终止执行的解决方案

问题背景

我网站通过GeoLocation及其他API优化用户体验，但访问日志和调试代码显示大量HEAD请求会触发所有代码与插件执行。核心问题是单IP每分钟访问量超120次，导致API返回HTTP 429错误，这类请求属于垃圾或恶意访问。我需要通过PHP检查机制，在HEAD请求时停止执行，减少服务器额外处理并避免外部API调用。

我测试过以下方法，但均未达到预期：

get_headers("http://example.com")：用于获取远程服务器响应头，无法检测当前请求方法
getallheaders()：仅返回请求头信息，不包含请求方法
$_SERVER['REQUEST_METHOD']：始终返回GET，未正确识别HEAD请求

解决方案

1. 先排查服务器配置问题

正常情况下$_SERVER['REQUEST_METHOD']应该能正确返回HEAD，如果显示为GET，大概率是服务器配置将HEAD请求强制转为了GET：

Apache：检查是否存在RewriteRule或相关模块篡改请求方法，确保无强制转换HEAD为GET的规则，Apache默认会正确传递HEAD请求方法
Nginx：确认配置中没有强制转换HEAD为GET的设置，Nginx默认支持正确处理HEAD请求

2. PHP中正确检测并处理HEAD请求

服务器配置修复后，可直接通过$_SERVER['REQUEST_METHOD']判断并终止执行：

if ($_SERVER['REQUEST_METHOD'] === 'HEAD') {
    // 发送必要响应头（如Content-Type、Content-Length）
    header('Content-Type: text/html');
    header('Content-Length: 0');
    // 立即终止脚本，避免后续代码执行与API调用
    exit;
}

如果服务器配置无法修改，可尝试检查请求头中的X-HTTP-Method-Override字段（若存在）辅助判断，但优先修复服务器配置是最优方案。