本文详解 http get 请求中自定义 header 与 url 查询参数的本质区别，指出常见混淆误区，并提供 delphi 客户端发送方式及 php 服务端正确接收方案。
在开发中，一个高频误区是：误将 HTTP 请求头（Header）当作 $_GET 参数使用。你当前的 PHP 脚本中通过 empty($_GET['test']) 判断字段，但客户端实际是通过 CustomHeaders.AddValue('test', 'text') 发送的——这并不会填充 $_GET，而是作为 HTTP 请求头（如 test: text）发送到服务器。而 PHP 的 $_GET 仅解析 URL 查询字符串（query string）中的键值对，例如 ?test=text；它完全不感知请求头内容。
✅ 正确做法一：若需传递业务参数 → 使用 URL 查询参数（推荐）
这是最标准、兼容性最强的方式，尤其适用于 RESTful 风格的 GET 接口：
// Delphi (TIdHTTP)
IdHttp1.Request.ContentType := 'application/x-www-form-urlencoded';
Memo1.Text := IdHttp1.Get('https://example.com/?test=text');// Delphi (THTTPClient)
Memo1.Text := NetHTTPClient1.Get('https://example.com/?test=text').ContentAsString;对应 PHP 端保持原样即可正常工作：
<?php
if (empty($_GET['test'])) {
echo '0';
} else {
echo '1'; // ✅ 此时输出 1
}
?>✅ 正确做法二：若确需读取自定义 Header → 从 $_SERVER 中提取
HTTP 头部字段在 PHP 中统一映射到 $_SERVER 超全局数组，命名规则为：
HTTP_ + 大写 Header 名 + 下划线替换所有非字母数字字符（如 - → _，空格 → _）。
立即学习“PHP免费学习笔记（深入）”；
例如，你发送的 test: text 头，在 PHP 中应通过 $_SERVER['HTTP_TEST'] 访问：
<?php
// 注意：Header 名 'test' 会被转为 'HTTP_TEST'
$customHeader = $_SERVER['HTTP_TEST'] ?? null;
if (empty($customHeader)) {
echo '0';
} else {
echo '1'; // ✅ 当客户端发送 test:text 时，此处输出 1
}
?>⚠️ 注意事项：
- Apache 默认会过滤掉自定义 Header（尤其是不含连字符的短名），建议使用带连字符的规范命名，如 X-App-Test；
- 若使用 X-App-Test: value，PHP 中应读取 $_SERVER['HTTP_X_APP_TEST']；
- Nginx 需显式启用 underscores_in_headers on; 并确保 fastcgi_param 透传（如 fastcgi_param HTTP_X_APP_TEST $http_x_app_test;）；
- 开发调试时可用 print_r($_SERVER); 查看所有可用 Header 键名。
? 快速验证技巧
在 PHP 端添加诊断代码，确认 Header 是否真正抵达：
file_put_contents('/tmp/debug.log', print_r($_SERVER, true), FILE_APPEND);
// 或直接返回全部 Header
header('Content-Type: text/plain');
echo "GET: " . print_r($_GET, true) . "\n";
echo "SERVER (HTTP_*): " . print_r(array_filter($_SERVER, fn($k) => str_starts_with($k, 'HTTP_')), true);总结
| 场景 | 客户端发送方式 | PHP 接收变量 | 说明 |
|---|---|---|---|
| 传递查询参数（如分页、筛选） | 拼入 URL：?key=value | $_GET['key'] | ✅ 标准、可靠、可缓存 |
| 传递认证/元数据（如 Token、追踪 ID） | 设置 Header：Authorization: Bearer xxx | $_SERVER['HTTP_AUTHORIZATION'] | ✅ 需注意大小写与下划线转换 |
| ❌ 错误用法 | CustomHeaders.AddValue('test', 'x') + $_GET['test'] | 始终为空 | $_GET 不读取 Header |
牢记：Header ≠ Query Parameter。选择哪种方式，取决于语义——参数参与资源定位用 GET，元信息控制行为用 Header。
