Guzzle 的 query 选项会完全替换 URL 中已有的查询字符串，若需保留原始参数并新增键值对，应先解析原 URL 的 query 部分，再合并新参数，最后统一传入请求。
guzzle 的 `query` 选项会完全替换 url 中已有的查询字符串，若需保留原始参数并新增键值对，应先解析原 url 的 query 部分，再合并新参数，最后统一传入请求。
在使用 Guzzle 发起 GET 请求时，一个常见误区是直接通过 'query' => [...] 选项传递参数——这会导致 URL 中已存在的查询参数被完全丢弃，仅保留 query 数组中的内容。例如：
$this->client->get("https://example.com?test=id&name=testname", [
'query' => ['option_1' => 'val1', 'option_2' => 'val2']
]);
最终请求 URL 将变为 https://example.com?option_1=val1&option_2=val2，原始 test 和 name 参数消失。
✅ 正确做法是：显式解析并合并查询参数，而非依赖 Guzzle 自动覆盖。推荐以下两种稳健方案：
方案一：手动拼接（简洁但需谨慎）
适用于参数结构简单、无编码风险的场景：
$url = "https://webhook.site/bb1ea111-517e-46f5-867e-e956a75753f0?test=id&name=testname";
$newParams = [
'option_1' => 'string',
'option_2' => 'string'
];
$mergedQuery = http_build_query($newParams);
$finalUrl = $url . '&' . $mergedQuery;
$response = $this->client->get($finalUrl);
⚠️ 注意：此方式要求原始 URL 的 query 部分必须以 ? 开头且不含重复键；若原始参数含特殊字符（如空格、中文），需确保已正确编码，否则 http_build_query() 可能导致双重编码。
方案二：解析 + 合并（推荐，健壮可靠）
利用 PHP 内置函数安全提取并融合参数：
$url = "https://webhook.site/bb1ea111-517e-46f5-867e-e956a75753f0?test=id&name=testname";
// 解析 URL 并提取 query 部分
$parsed = parse_url($url);
parse_str($parsed['query'] ?? '', $existingParams);
// 合并新参数（新参数优先级可自定义）
$mergedParams = array_merge($existingParams, [
'option_1' => 'string',
'option_2' => 'string'
]);
// 发起请求：传入原始 URL + 合并后的 query 数组
$response = $this->client->get($url, [
'query' => $mergedParams
]);
✅ 优势：自动处理 URL 编码/解码，兼容任意合法 query 字符串，避免手动拼接错误；array_merge 确保逻辑清晰，冲突时新值覆盖旧值（如需保留旧值，可调整合并顺序）。
补充说明
- Guzzle 7+ 版本中，$client->get() 第二个参数为请求选项数组，'query' 键值将完全替代 URL 中的查询字符串——这是设计行为，非 bug。
- 若需动态构造 URL，建议封装为工具方法，复用解析逻辑：
function mergeQueryParams(string $url, array $newParams): string { $parsed = parse_url($url); parse_str($parsed['query'] ?? '', $oldParams); $merged = array_merge($oldParams, $newParams); $parsed['query'] = http_build_query($merged); return $parsed['scheme'] . '://' . $parsed['host'] . $parsed['path'] . '?' . $parsed['query']; }
始终优先采用方案二，兼顾安全性、可维护性与兼容性。
