PHP8.0版本新增的HTTP客户端库

PHP8.0中的HTTP客户端库

PHP8.0的发布带来了很多新特性和改进，其中一个最引人注目的是内置的HTTP客户端库的加入。这个库提供了一个简单的方法来发送HTTP请求并处理返回的响应。在本文中，我们将探讨这个库的主要功能和用法。

发送HTTP请求

使用PHP8.0内置的HTTP客户端库发送HTTP请求非常简单。在本例中，我们将使用GET方法获取这个网站的首页：

use HttpClientExceptionHttpException;
use HttpClientHttpClient;
use HttpMessageRequestFactory;
use HttpMessageStreamFactory;

require_once "vendor/autoload.php";

// Create the client
$httpClient = HttpClientDiscovery::find();

// Create the request
$requestFactory = new RequestFactory();
$request = $requestFactory->createRequest(
    'GET',
    'http://example.com'
);

// Send the request and wait for the response
try {
    $response = $httpClient->sendRequest($request);
} catch (HttpException $e) {
    echo 'Error: ' . $e->getMessage();
    exit;
}

// Print the response body
$body = (string) $response->getBody();
echo $body;

这个例子中，我们首先使用工厂类方法HttpClientDiscovery::find()创建一个HTTP客户端。然后，使用RequestFactory::createRequest()方法创建一个HTTP请求，指定请求方法和请求URL。最后，使用HttpClient::sendRequest()方法发送请求，并等待响应。如果请求发送失败，则会引发HttpException异常。

处理响应

在接收到响应后，我们可以使用HTTP响应对象来访问响应状态、响应头和响应体。在下面的代码中，我们将打印一个表示响应状态、响应头和响应体的字符串。

use HttpMessageResponseFactory;

$responseFactory = new ResponseFactory();
$status = $response->getStatusCode();
$headers = $response->getHeaders();
$body = (string) $response->getBody();

$responseString = sprintf(
    "HTTP/%s %s
%s

%s",
    $response->getProtocolVersion(),
    $status,
    implode("
", $headers),
    $body
);

echo $responseString;

这里，我们使用ResponseFactory::createResponse()方法创建一个HTTP响应对象。然后，使用ResponseInterface接口提供的方法来访问响应状态、响应头和响应体。最后，我们将响应组合成一个字符串，然后在屏幕上打印出来。

处理响应体

当我们发送HTTP请求并从服务器接收到响应时，我们也可以处理响应体。让我们看一下，如何处理JSON响应体：

use HttpMessageJsonResponseFactory;

$responseFactory = new JsonResponseFactory();
$decoded = $responseFactory->createResponse($response)->getPayload();

echo 'The decoded response is:' . PHP_EOL;
print_r($decoded);

在这个例子中，我们使用JsonResponseFactory::createResponse()方法创建一个JSON格式的HTTP响应对象。然后，使用JsonResponseInterface接口提供的getPayload()方法来解码JSON响应体。最后，我们将解码后的响应体打印到控制台上。

处理异常

在使用HTTP客户端库时，有时请求可能会失败，这可能是因为网络连接错误或服务器故障。当这种情况发生时，HTTP客户端库将引发一个HttpException异常。在下面的代码片段中，我们将捕获这个异常并打印出错误消息。

use HttpClientExceptionHttpException;

// ...

try {
    $response = $httpClient->sendRequest($request);
} catch (HttpException $e) {
    echo 'Error: ' . $e->getMessage();
    exit;
}

如果出现异常，将显示一个错误消息并退出程序。这允许我们在请求失败时采取适当的措施，例如打印错误消息或重新尝试请求。

结论

HTTP客户端库是PHP8.0中的一个重要新功能。它提供了一个强大的方式来发送HTTP请求并处理响应。在本文中，我们已经介绍了HTTP客户端库的主要功能和用法，包括发送HTTP请求、处理响应、处理响应体和处理异常。现在，我们已经可以在我们的PHP应用程序中使用HTTP客户端库了。