正确命令是 composer require symfony/http-client，它默认安装最新稳定版并自动处理依赖；若类未找到需运行 composer dump-autoload；Symfony 全栈 v5.4+ 已预装，无需重复安装。
Composer 安装 symfony/http-client 的正确命令
直接运行 composer require symfony/http-client 就行，不需要额外加 --dev 或指定版本（除非你有明确兼容需求）。它默认安装最新稳定版，并自动拉取依赖的 symfony/event-dispatcher、psr/http-client 等组件。
常见错误现象：Class "Symfony\Component\HttpClient\HttpClient" not found —— 多半是没执行 composer install 或 autoloader 没刷新，试下 composer dump-autoload。
- 如果你用的是 Symfony 全栈框架（v5.4+），
symfony/http-client已预装，不用再require - 不推荐手动指定版本如
composer require symfony/http-client:^6.4，除非你在维护老项目且明确需要 LTS 版本 - 注意：PHP 版本需 ≥ 8.1（v6.x）或 ≥ 7.2（v5.x），低版本会报错
Your requirements could not be resolved
用 HttpClient 替代 Guzzle 发 GET/POST 请求的最小代码差异
核心区别不在语法多复杂，而在「默认行为」和「异常处理逻辑」——Guzzle 默认抛异常（GuzzleHttp\Exception\RequestException），HttpClient 默认不抛（$response->getStatusCode() 需手动检查）。
示例：发一个带 JSON body 的 POST 请求
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
// Guzzle（旧习惯）
$response = $client->post('https://api.example.com/login', [
'json' => ['user' => 'foo', 'pass' => 'bar'],
]);
$data = json_decode($response->getBody(), true);
// HttpClient（新写法）
$client = \Symfony\Component\HttpClient\HttpClient::create();
$response = $client->request('POST', 'https://api.example.com/login', [
'json' => ['user' => 'foo', 'pass' => 'bar'],
]);
// ⚠️ 这里不会自动 throw！要自己判断
if (200 !== $response->getStatusCode()) {
throw new \RuntimeException('API error: '.$response->getStatusCode());
}
$data = $response->toArray(); // 自动 json_decode + 检查 Content-Type
-
$response->toArray()比json_decode($response->getContent(), true)更安全：它校验Content-Type: application/json并抛出JsonException - GET 参数用
'query' => ['page' => 1, 'limit' => 10]，和 Guzzle 一致；但'headers'键名必须小写（'user-agent'✅，'User-Agent'❌） - 超时单位是秒（float），不是毫秒：
'timeout' => 5.5表示 5.5 秒，Guzzle v7+ 也是秒，这点已统一
HttpClient 的异步请求怎么写才不踩坑
异步不是靠 ->request() 本身，而是用 ->withOptions(['max_duration' => 10]) + $client->stream() 组合实现真正非阻塞。很多人误以为 ->request() 返回 Promise 就是异步——其实它是同步发起、延迟读取。
- 错误写法：多个
$client->request()连续调用 → 仍是串行，没提速 - 正确模式：先批量
request()得到ResponseInterface对象数组，再用$client->stream($responses)一次性轮询响应 - 流式响应（
stream选项）必须显式启用：['stream' => true]，否则$response->getStream()返回 null - 内存敏感场景慎用
$response->getContent()：它会把整个响应体加载进内存；大文件请用$response->toStream()直接 pipe 到文件
替换 Guzzle 后 curl 扩展报错或连接失败怎么办
HttpClient 底层默认用 curl，但会跳过一些 Guzzle 里被惯用的低级配置。如果出现 cURL error 60: SSL certificate problem 或连接超时，大概率是证书路径或代理没对齐。
- 强制指定 CA bundle：
HttpClient::create(['cafile' => '/path/to/cacert.pem'])，别依赖系统默认（尤其 Windows / Docker） - 代理设置不能只写
http_proxy环境变量：HttpClient 只认HTTP_PROXY和HTTPS_PROXY（全大写），且不支持no_proxy的通配符（只支持逗号分隔的域名列表） - 禁用 SSL 验证仅用于调试：
['verify_peer' => false, 'verify_host' => false]，上线必须删掉 - 某些内网环境需要显式关掉 HTTP/2：
['http_version' => '1.1']，避免服务端不兼容导致 hang 住
最常被忽略的一点：HttpClient 不自动重试失败请求，Guzzle 的 retry_failed 中间件逻辑得自己补，用 RetryableHttpClient 包或手写 retry 循环。
