PHP 中使用 cURL 发送带认证头和查询参数的 GET 请求完整示例-php教程-PHP中文网

PHP 中使用 cURL 发送带认证头和查询参数的 GET 请求完整示例

本文详解如何在 php 中将命令行 curl 命令（含自定义 header、query 参数和 token 认证）准确转换为可执行的 curl 函数调用，并提供健壮、可复用的代码模板。

本文详解如何在 php 中将命令行 curl 命令（含自定义 header、query 参数和 token 认证）准确转换为可执行的 curl 函数调用，并提供健壮、可复用的代码模板。

在 PHP 开发中，常需将调试通过的命令行 curl 请求迁移至生产代码中。以如下典型请求为例：

curl -X GET "https://example.com/nms/api/v2.1/devices?withInterfaces=true&authorized=false&type=uisps&role=switch" \
  -H "accept: application/json" \
  -H "x-auth-token: wsedr4455-3345-es45-2345-4edeesssd"

该请求为标准的 GET 方法，携带 4 个 URL 查询参数（withInterfaces, authorized, type, role），并设置两个关键请求头：Accept 和自定义认证头 X-Auth-Token。

对应的 PHP 实现应使用 curl_init() 初始化句柄，配合 curl_setopt() 精确配置行为。以下是推荐的完整、健壮写法：

CurlShip Directory Submission

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

下载

<?php // 构建完整 URL（建议对参数进行 urlencode，提升安全性与兼容性）
$query = http_build_query([
    'withInterfaces' => 'true',
    'authorized'     => 'false',
    'type'           => 'uisps',
    'role'           => 'switch'
]);
$url = 'https://example.com/nms/api/v2.1/devices?' . $query;

$ch = curl_init($url);

// 关键配置项
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);   // 返回字符串而非直接输出
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, false); // 不自动跳转（避免意外重定向）
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' // 推荐添加，部分 API 会校验 UA
]);

// 执行请求
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

// 检查错误
if (curl_errno($ch)) {
    throw new RuntimeException('cURL error: ' . curl_error($ch));
}

curl_close($ch);

// 解析响应（假设返回 JSON）
if ($httpCode === 200 && !empty($response)) {
    $data = json_decode($response, true);
    if (json_last_error() !== JSON_ERROR_NONE) {
        throw new RuntimeException('Invalid JSON response');
    }
    print_r($data);
} else {
    throw new RuntimeException("API request failed with HTTP {$httpCode}");
}

✅ 关键注意事项：