SymfonyHTTP客户端怎么用_请求发送方法【教程】-php教程-PHP中文网

symfony http 客户端是轻量现代工具，用于调用第三方 api 或微服务，支持同步/异步、重试、超时、json 自动序列化；需 composer 安装，通过 request() 发送请求，toarray() 自动解析 json，异常分 transport/client/server 三类处理。

symfonyhttp客户端怎么用_请求发送方法【教程】

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()：

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

带 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 错误：服务不可用，可触发告警
}

不复杂但容易忽略