symfony 项目中使用内置 httpclient 组件发起安全、可配置、可测试的 http 请求，需先安装 symfony/http-client，支持构造函数注入默认客户端或通过 clientregistry 获取命名客户端，并提供 json 选项简化 post 请求。
在 Symfony 项目中创建 HTTP 客户端，是为了发起安全、可配置、可测试的 HTTP 请求，比如调用第三方 API 或微服务接口。你不需要手动安装 Guzzle 或 cURL 封装器，Symfony 自带的 HttpClient 组件已深度集成，开箱即用。
确认 HttpClient 组件已安装
运行 composer show symfony/http-client 检查是否已存在。若未安装，执行：composer require symfony/http-client。这一步必须完成，否则后续所有调用都会抛出 Class not found 错误。
安装后，组件会自动注册为 http_client 服务，无需额外配置即可注入使用。
在控制器中直接使用 HttpClient
方法一：通过构造函数注入（推荐）
在控制器类中声明 Symfony\Contracts\HttpClient\HttpClientInterface 类型提示，Symfony 自动注入默认客户端实例：
public function __construct(private HttpClientInterface $client) {}
然后在动作方法里调用：$response = $this->client->request('GET', 'https://api.example.com/data');
这一步操作起来很简单，直接把 URL 传进去就行，但注意：请求默认不超时，生产环境必须显式设置超时，否则可能卡死整个请求周期。
自定义配置化客户端（非默认）
第一步：在 config/packages/http_client.yaml 中定义命名客户端
symfony_http_client: clients: github_api: base_uri: 'https://api.github.com/' headers: { 'User-Agent': 'MyApp/1.0' } timeout: 5
第二步：在服务中按名称获取客户端
使用 $this->clientRegistry->getClient('github_api') 获取该配置实例，【clientRegistry 必须从 Symfony\Contracts\HttpClient\HttpClientFactoryInterface 注入】，否则会报服务未找到。
第三步：发起请求时自动携带 base_uri 和 headers
$response = $client->request('GET', '/users/octocat'); → 实际请求地址是 https://api.github.com/users/octocat，无需拼接域名。
发送带 JSON Body 的 POST 请求
方法一：用 json 选项（最简洁）
$response = $this->client->request('POST', 'https://httpbin.org/post', ['json' => ['name' => 'Alice', 'age' => 30]]);
方法二：手动设置 body + Content-Type
$response = $this->client->request('POST', 'https://httpbin.org/post', [ 'body' => json_encode(['name' => 'Alice']), 'headers' => ['Content-Type' => 'application/json']]);
注意：方法一自动设置 header 并处理序列化，方法二需确保手动 json_encode 不出错，且没遗漏 header——漏掉会导致后端返回 415 Unsupported Media Type。
