如何在 PHP 中使用 cURL 发送带认证头和查询参数的 GET 请求-php教程-PHP中文网

如何在 PHP 中使用 cURL 发送带认证头和查询参数的 GET 请求

本文详解如何将命令行 curl 命令（含自定义 header、get 参数及 token 认证）完整转换为安全、可维护的 php curl 代码，并提供错误处理与 json 解析建议。

本文详解如何将命令行 curl 命令（含自定义 header、get 参数及 token 认证）完整转换为安全、可维护的 php curl 代码，并提供错误处理与 json 解析建议。

在 PHP 开发中，经常需要调用第三方 RESTful API。上述 curl -X GET 命令包含关键要素：带多个查询参数的 URL、Accept: application/json 声明、以及必需的 x-auth-token 认证头。直接翻译为 PHP cURL 时，需注意初始化、选项设置、执行与资源释放的完整流程。

以下是推荐的生产级实现（已增强健壮性）：

<?php $url = 'https://example.com/nms/api/v2.1/devices?withInterfaces=true&authorized=false&type=uisps&role=switch';

$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_HTTPGET, true);         // 显式声明 GET 方法
curl_setopt($ch, CURLOPT_TIMEOUT, 30);           // 设置超时（秒）
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Accept: application/json',
    'x-auth-token: wsedr4455-3345-es45-2345-4edeesssd',
    'User-Agent: PHP-cURL/1.0' // 推荐添加，避免部分服务端拦截
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);

curl_close($ch);

// 错误处理与 JSON 解析
if ($response === false) {
    throw new RuntimeException("cURL error: {$error}");
}

if ($httpCode !== 200) {
    throw new RuntimeException("API request failed with HTTP {$httpCode}");
}

$data = json_decode($response, true);
if (json_last_error() !== JSON_ERROR_NONE) {
    throw new RuntimeException('Invalid JSON response received');
}

// 此时 $data 是关联数组，可直接使用
print_r($data);

⚠️ 重要注意事项：

CurlShip Directory Submission

向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。

下载

Token 安全：切勿将 x-auth-token 硬编码在源码中；应通过环境变量（如 getenv('API_TOKEN')）或配置中心注入；
URL 构建：若参数动态生成，建议使用 http_build_query() 拼接查询字符串，避免手动拼接导致编码错误；
SSL 验证：生产环境务必保持 CURLOPT_SSL_VERIFYPEER（默认开启）和 CURLOPT_SSL_VERIFYHOST 启用，禁用它们会带来严重安全风险；
异常封装：实际项目中建议将上述逻辑封装为可复用的 API 客户端类，并统一处理重试、日志与监控。