本文详解在使用 guzzle 发送 get 请求时，如何将新查询参数与 url 中已有的查询字符串合并，避免因直接传入 query 选项导致原始参数被意外清除。
本文详解在使用 guzzle 发送 get 请求时，如何将新查询参数与 url 中已有的查询字符串合并，避免因直接传入 query 选项导致原始参数被意外清除。
Guzzle 的 query 请求选项设计为完全替换 URL 中的查询参数，而非追加。因此，当你传入类似 'query' => ['option_1' => 'val'] 时，Guzzle 会忽略 URL 中已有的 ?test=id&name=testname，仅保留你显式指定的参数——这正是问题中请求 URL 被“重写”的根本原因。
要实现参数的安全追加（即保留原始参数 + 合并新增参数），推荐以下两种稳健方案：
✅ 方案一：手动拼接查询字符串（简洁直接）
适用于参数结构简单、URL 来源可信的场景。使用 PHP 原生函数 http_build_query() 构建新增参数，并直接拼接到原始 URL 后：
$baseUri = "https://webhook.site/bb1ea111-517e-46f5-867e-e956a75753f0?test=id&name=testname";
$newParams = [
'option_1' => 'string',
'option_2' => 'string'
];
// 自动编码并拼接
$fullUrl = $baseUri . '&' . http_build_query($newParams);
$response = $this->client->get($fullUrl); // 注意：Guzzle 7+ 使用 get()，非 GET()
⚠️ 注意：此方法要求原始 URL 已含 ?，且需确保 & 拼接逻辑正确（若原 URL 无查询参数，应改用 ?）。
✅ 方案二：解析 + 合并 + 重构（推荐，健壮可靠）
适用于生产环境或 URL 来源不可控（如来自数据库）的场景。通过 parse_url() 和 parse_str() 安全提取原始参数，再与新参数合并：
$url = "https://webhook.site/bb1ea111-517e-46f5-867e-e956a75753f0?test=id&name=testname";
// 解析 URL 并提取 query 部分
$parsed = parse_url($url);
parse_str($parsed['query'] ?? '', $existingParams); // 兼容无 query 的 URL
// 合并参数（新参数优先级可按需调整）
$mergedParams = array_merge($existingParams, [
'option_1' => 'string',
'option_2' => 'string'
]);
// 重构完整 URL（自动处理编码）
$finalUrl = $parsed['scheme'] . '://' . $parsed['host'] . $parsed['path'];
if (!empty($mergedParams)) {
$finalUrl .= '?' . http_build_query($mergedParams);
}
$response = $this->client->get($finalUrl);
? 关键优势：
- 自动处理 URL 编码/解码，避免手动拼接引发的乱码或注入风险；
- 兼容无查询参数、含特殊字符（如空格、中文）、重复键等边界情况；
- 逻辑清晰，易于单元测试和维护。
⚠️ 重要提醒
- Guzzle 6.x 与 7.x+ 的 API 差异：$client->GET() 已废弃，请统一使用 $client->get($url, $options)；
- 若需动态构建请求，建议封装为复用函数，例如 buildMergedUrl(string $baseUrl, array $newParams): string；
- 永远避免直接拼接用户输入到 URL 中——务必通过 http_build_query() 或 urlencode() 保证安全性。
通过以上任一方法，即可确保最终请求 URL 正确包含全部参数：
https://webhook.site/bb1ea111-517e-46f5-867e-e956a75753f0?test=id&name=testname&option_1=string&option_2=string
