PHP cURL GET 请求：正确设置请求头与身份认证

本文详解如何在 php 中使用 curl 发起带认证和自定义请求头的 get 请求，纠正将 shell 命令误写入 `curlopt_url` 的常见错误，并提供可直接运行的安全示例。

在 php 中使用 cURL 发起 http 请求时，一个常见误区是把终端命令（如 curl -u user:pass -H “Accept: text/csv” …）直接拼接进 CURLOPT_URL——这会导致 cURL 尝试访问一个非法 URL，最终返回空结果或报错。正确的做法是：URL 仅包含协议、主机、路径和查询参数；认证、请求头、方法等需通过独立的 curl_setopt() 选项设置。

以下是标准、安全、可复用的 PHP cURL GET 请求模板（支持 Basic Auth 和自定义 Header）：

 'chiave: "2022-01-26_14:46"',     'range'     => 160000,     'batch_size'=> 500,     'fields'    => 'ALERTID, chiave' ]);  $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HEADER, false); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true); curl_setopt($ch, CURLOPT_TIMEOUT, 30);  // ✅ 设置 Accept 请求头 curl_setopt($ch, CURLOPT_HTTPHEADER, [     'Accept: text/csv',     'User-Agent: PHP-cURL/1.0' ]);  // ✅ 正确设置 Basic 认证（推荐方式） curl_setopt($ch, CURLOPT_USERPWD, 'username:password'); curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);  // ⚠️ 注意：不要使用 CURLOPT_POST + CURLOPT_POSTFIELDS 实现 GET 认证！ // 上述答案中建议的 CURLOPT_POST=1 是错误的——GET 请求不应设为 POST， // 且 CURLOPT_POSTFIELDS 用于提交请求体，不适用于 Basic Auth。  $result = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); $error = curl_error($ch);  curl_close($ch);  if ($result === false) {     throw new RuntimeException("cURL error: {$error} (HTTP {$httpCode})"); }  echo $result; ?>

关键要点说明：

• CURLOPT_USERPWD 是设置 Basic Authentication 的标准方式，cURL 会自动编码并添加 Authorization: Basic 请求头；
• CURLOPT_HTTPHEADER 用于添加任意自定义头（如 Accept, Content-Type），注意格式为 ‘Key: Value’ 字符串数组；
• 切勿在 CURLOPT_URL 中混入 -X GET、–header 或 shell 管道（如 | wc -l）——这些属于命令行工具语法，PHP cURL 不识别；
• 若 API 使用 Bearer Token，应改用：

  curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer your-token-here']);

• 生产环境务必对敏感凭证（如用户名/密码）进行加密管理或从环境变量读取，避免硬编码。

遵循以上规范，即可稳定、清晰、安全地完成带认证与请求头的 PHP cURL GET 调用。

立即学习“PHP免费学习笔记（深入）”；