Symfony HTTP 客户端是轻量现代工具，用于调用第三方 API 或微服务，支持同步/异步、重试、超时、JSON 自动序列化；需 Composer 安装，通过 request() 发送请求，toArray() 自动解析 JSON，异常分 Transport/Client/Server 三类处理。
Symfony HTTP 客户端是发送外部 HTTP 请求的轻量、现代工具，不是用来测自己项目的控制器（那是 WebTestCase 的测试客户端），而是用于调用第三方 API 或微服务。它支持同步/异步、重试、超时、JSON 自动序列化等，API 清晰，开箱即用。
安装与基础请求
先通过 Composer 安装：
composer require symfony/http-client
在服务中注入或直接实例化即可使用。最简 GET 请求示例：
$client = \Symfony\Component\HttpClient\HttpClient::create();
$response = $client->request('GET', 'https://api.example.com/users');
$content = $response->getContent(); // 返回字符串
$data = $response->toArray(); // 自动 JSON 解码为数组（响应 Content-Type 为 application/json 时）
注意：toArray() 会校验状态码，非 2xx 会抛异常；若需忽略，加选项 ['throw' => false]。
常用请求配置
大多数场景只需传一个配置数组给 request()：
- 带 JSON body 的 POST：
$client->request('POST', '/login', ['json' => ['email' => 'a@b.c', 'password' => '123']]) - 自定义 Header：
['headers' => ['Authorization' => 'Bearer xyz']] - 查询参数（自动拼到 URL）：
['query' => ['page' => 2, 'limit' => 10]] - 超时控制：
['timeout' => 5]（单位：秒） - 禁用 SSL 验证（仅开发）：
['verify_peer' => false, 'verify_peer_name' => false]
处理重试逻辑
默认不重试。要启用，需用 RetryableHttpClient 包装：
use Symfony\Component\HttpClient\RetryableHttpClient;
use Symfony\Component\HttpClient\HttpClient;
$client = new RetryableHttpClient(
HttpClient::create(),
[
'max_retries' => 3,
'delay_ms' => 1000,
'http_codes' => [500, 502, 503, 504],
]
);
$response = $client->request('GET', 'https://api.example.com/status');
注意：POST/PUT/DELETE 默认不重试（因非幂等）。如需重试，必须确认服务端支持幂等性，并显式添加 'retry_strategy' => ['methods' => ['GET', 'HEAD', 'POST']]。
错误与异常处理
网络失败（如连接超时、DNS 错误）会抛 TransportException；HTTP 错误（如 404、500）默认也抛异常。建议按需捕获：
try {
$response = $client->request('GET', $url);
return $response->toArray();
} catch (\Symfony\Contracts\HttpClient\Exception\TransportExceptionInterface $e) {
// 网络层问题：重试、降级、记录日志
} catch (\Symfony\Contracts\HttpClient\Exception\ClientExceptionInterface $e) {
// 4xx 错误：检查参数或权限
} catch (\Symfony\Contracts\HttpClient\Exception\ServerExceptionInterface $e) {
// 5xx 错误：服务不可用，可触发告警
}
不复杂但容易忽略
