В мире веб-разработки и интеграции API GuzzleHTTP стала популярной PHP-библиотекой для выполнения HTTP-запросов. Он предоставляет удобный и мощный способ взаимодействия с веб-сервисами, но что происходит, когда возникают ошибки? В этой статье мы погрузимся в мир обработки ошибок в GuzzleHTTP, изучая различные методы корректной обработки и управления ошибками HTTP.

Понимание ошибок HTTP:

Прежде чем мы углубимся в различные методы обработки ошибок, давайте кратко обсудим ошибки HTTP. Ошибки HTTP — это коды состояния, возвращаемые сервером для обозначения успеха или неудачи запроса. Они варьируются от 400 до 599, и каждый код состояния имеет определенное значение. Например, код состояния 404 указывает на то, что запрошенный ресурс не найден.

Метод 1. Проверка ошибок HTTP с помощью опции http_errors:

Один из самых простых способов обработки ошибок HTTP в GuzzleHTTP — использование параметра http_errors. Когда эта опция включена, GuzzleHTTP генерирует исключение для любого неуспешного ответа. Чтобы включить эту опцию, вы можете использовать следующий фрагмент кода:

use GuzzleHttp\Client;
$client = new Client([
    'http_errors' => true
]);
$response = $client->get('https://api.example.com/resource');
// The request will throw an exception if it encounters an HTTP error

Метод 2. Проверка кодов состояния HTTP вручную:

Если вы предпочитаете больше контроля над обработкой ошибок, вы можете вручную проверить коды состояния HTTP, возвращаемые сервером. GuzzleHTTP предоставляет метод getResponse(), который позволяет вам получить доступ к базовому объекту ответа. Вот пример:

$response = $client->get('https://api.example.com/resource');
if ($response->getStatusCode() >= 400) {
    // Handle the HTTP error
}

Метод 3. Использование исключений для определенных кодов состояния:

Иногда вам может потребоваться по-другому обрабатывать определенные коды ошибок HTTP. GuzzleHTTP позволяет вам перехватывать исключения для определенных кодов состояния, используя класс RequestException. Вот пример:

use GuzzleHttp\Exception\RequestException;
try {
    $response = $client->get('https://api.example.com/resource');
} catch (RequestException $e) {
    if ($e->getResponse()->getStatusCode() === 404) {
        // Handle the 404 error
    }
}

Метод 4. Пользовательская обработка ошибок с помощью промежуточного программного обеспечения:

GuzzleHTTP предоставляет систему промежуточного программного обеспечения, которая позволяет вам настроить процесс обработки ошибок. Вы можете создать собственное промежуточное программное обеспечение для перехвата и обработки определенных типов ошибок. Вот простой пример:

$handlerStack = \GuzzleHttp\HandlerStack::create();
$handlerStack->push(function (callable $handler) {
    return function ($request, array $options) use ($handler) {
        return $handler($request, $options)->then(function ($response) {
            if ($response->getStatusCode() >= 400) {
                // Handle the HTTP error
            }
            return $response;
        });
    };
});
$client = new Client([
    'handler' => $handlerStack
]);
$response = $client->get('https://api.example.com/resource');

В этой статье мы рассмотрели несколько методов обработки ошибок HTTP в GuzzleHTTP. Предпочитаете ли вы простоту опции http_errorsили гибкость ручной проверки ошибок и настраиваемого промежуточного программного обеспечения, GuzzleHTTP предлагает ряд опций, отвечающих вашим потребностям. Эффективно обрабатывая ошибки HTTP, вы можете повысить надежность и надежность своих приложений, обеспечивая удобство для пользователей.