Guzzle发起GET请求如何追加查询参数且不覆盖URL原有参数

Guzzle 传入query请求选项时，默认会全量覆盖原始URL中携带的查询字符串，不会自动执行参数合并逻辑，这就是原有test、name参数丢失的直接原因。

针对从数据库读取动态URL的业务场景，优先选择参数合并的方案，兼容性最好。

方案1：解析原始参数后合并（推荐） #

通过PHP内置函数解析原始URL中的查询参数，和自定义新增参数合并后再传入query选项，完全适配动态URL场景，不需要关心原始URL是否带参数、参数格式是什么：

// 从数据库读取的动态URL
$dynamicUrl = "https://webhook.site/bb1ea111-517e-46f5-867e-e956a75753f0?test=id&name=testname";
// 解析原始URL的组成部分
$urlParts = parse_url($dynamicUrl);
$originParams = [];
// 提取原始URL中已有的查询参数
if (isset($urlParts['query'])) {
    parse_str($urlParts['query'], $originParams);
}
// 合并原有参数、新增自定义参数，重名参数会以后续新增的值为准
$allParams = array_merge($originParams, [
    'option_1' => 'string',
    'option_2' => 'string'
]);
// 发起请求
$response = $this->client->get($dynamicUrl, [
    'query' => $allParams
]);

执行后最终请求的URL会完全符合预期，同时保留原有参数和新增参数。

方案2：手动拼接参数到URL #

如果场景简单，也可以直接把新增参数通过http_build_query拼接到原始URL末尾，不需要传query选项：

$dynamicUrl = "https://webhook.site/bb1ea111-517e-46f5-867e-e956a75753f0?test=id&name=testname";
$newParams = [
    'option_1' => 'string',
    'option_2' => 'string'
];
// 自动判断拼接符，避免URL没有?时拼接错误
$joinFlag = str_contains($dynamicUrl, '?') ? '&' : '?';
$fullUrl = $dynamicUrl . $joinFlag . http_build_query($newParams);
$response = $this->client->get($fullUrl);

• Guzzle 没有提供自动追加查询参数的配置项，只要传入query选项就会覆盖原有URL的查询参数，不要依赖框架自动合并
• 合并参数时如果存在同名参数，array_merge后新增的参数值会覆盖原有参数值，符合常规业务逻辑
• 参数拼接时必须用http_build_query处理参数，避免特殊字符转义问题导致请求异常

内容的提问来源于stack exchange，提问作者Mukesh