Исключения¶

<?php

require_once 'vendor/autoload.php';

use NotKinopoisk\Client;
use NotKinopoisk\Exception\ApiException;
use NotKinopoisk\Exception\InvalidApiKeyException;
use NotKinopoisk\Exception\RateLimitException;
use NotKinopoisk\Exception\ResourceNotFoundException;
use NotKinopoisk\Exception\KpValidationException;

// Создание клиента
$client = new Client('your-api-key');

// Обработка различных типов исключений
try {
    $film = $client->films->getById(999999);
    echo "Фильм получен: {$film->getDisplayName()}\n";
} catch (ResourceNotFoundException $e) {
    echo "Фильм не найден: {$e->getMessage()}\n";
    echo "Код ошибки: {$e->getCode()}\n";
} catch (RateLimitException $e) {
    echo "Превышен лимит запросов: {$e->getMessage()}\n";
    echo "Код ошибки: {$e->getCode()}\n";
    // Ждем и повторяем
    sleep(1);
} catch (InvalidApiKeyException $e) {
    echo "Неверный API ключ: {$e->getMessage()}\n";
    echo "Код ошибки: {$e->getCode()}\n";
} catch (KpValidationException $e) {
    echo "Ошибка валидации: {$e->getMessage()}\n";
    echo "Код ошибки: {$e->getCode()}\n";
} catch (ApiException $e) {
    echo "Общая ошибка API: {$e->getMessage()}\n";
    echo "Код ошибки: {$e->getCode()}\n";
}

// Создание базового исключения API
$apiException = new ApiException('Ошибка сети при обращении к API', 500);

echo "Сообщение: {$apiException->getMessage()}\n";
echo "Код: {$apiException->getCode()}\n";

// Создание исключения с цепочкой
$previousException = new Exception('Ошибка сети');
$apiException = new ApiException('Не удалось получить данные', 500, $previousException);

if ($apiException->getPrevious()) {
    echo "Причина: " . $apiException->getPrevious()->getMessage() . "\n";
}

// Создание специализированных исключений
$notFoundException = new ResourceNotFoundException('Фильм с ID 12345 не существует');
$rateLimitException = new RateLimitException();
$invalidKeyException = new InvalidApiKeyException();
$validationException = new KpValidationException('Некорректные данные фильма');

// Функция для безопасного выполнения API запросов
function safeApiCall(callable $apiCall, string $operation = 'API операция'): mixed {
    try {
        return $apiCall();
    } catch (ApiException $e) {
        logApiError($e, $operation);
        return null;
    }
}

// Функция для логирования ошибок API
function logApiError(ApiException $e, string $operation): void {
    $logMessage = sprintf(
        "[%s] API Error in %s: %s (Code: %d) in %s:%d",
        date('Y-m-d H:i:s'),
        $operation,
        $e->getMessage(),
        $e->getCode(),
        $e->getFile(),
        $e->getLine()
    );

    error_log($logMessage);

    if ($e->getPrevious()) {
        error_log("Previous exception: " . $e->getPrevious()->getMessage());
    }
}

// Использование
$film = safeApiCall(
    fn() => $client->films->getById(123),
    'получение фильма по ID'
);

if ($film === null) {
    echo "Не удалось получить фильм\n";
}

// Функция для получения детальной информации об ошибке
function getApiErrorDetails(ApiException $e): array {
    return [
        'message' => $e->getMessage(),
        'code' => $e->getCode(),
        'file' => $e->getFile(),
        'line' => $e->getLine(),
        'trace' => $e->getTraceAsString(),
        'previous' => $e->getPrevious() ? [
            'message' => $e->getPrevious()->getMessage(),
            'code' => $e->getPrevious()->getCode(),
            'class' => get_class($e->getPrevious())
        ] : null
    ];
}

// Функция для определения типа ошибки по коду
function getApiErrorType(int $code): string {
    return match (true) {
        $code >= 400 && $code < 500 => 'Client Error',
        $code >= 500 && $code < 600 => 'Server Error',
        $code === 0 => 'Network Error',
        default => 'Unknown Error'
    };
}

// Функция для создания пользовательского сообщения об ошибке
function createUserFriendlyMessage(ApiException $e): string {
    $errorType = getApiErrorType($e->getCode());

    return match ($errorType) {
        'Client Error' => 'Ошибка запроса. Проверьте параметры и попробуйте снова.',
        'Server Error' => 'Ошибка сервера. Попробуйте позже.',
        'Network Error' => 'Ошибка сети. Проверьте подключение к интернету.',
        default => 'Произошла неизвестная ошибка: ' . $e->getMessage()
    };
}

// Использование
try {
    $client->films->getById(999999);
} catch (ApiException $e) {
    $errorDetails = getApiErrorDetails($e);
    $userMessage = createUserFriendlyMessage($e);

    echo "Пользовательское сообщение: {$userMessage}\n";
    echo "Тип ошибки: " . getApiErrorType($e->getCode()) . "\n";
    echo "Детали ошибки:\n";
    print_r($errorDetails);
}

// Обработка не найденных ресурсов
try {
    $film = $client->films->getById(999999);
} catch (ResourceNotFoundException $e) {
    echo "Ресурс не найден: {$e->getMessage()}\n";
    // Можно попробовать поиск по названию
    $searchResults = $client->films->searchByKeyword('матрица');
    if (!$searchResults->isEmpty()) {
        echo "Найдены похожие фильмы\n";
    }
}

// Обработка превышения лимита
try {
    $films = $client->films->getTop();
} catch (RateLimitException $e) {
    echo "Превышен лимит запросов\n";
    // Ждем и повторяем
    sleep(2);
    $films = $client->films->getTop();
}

// Обработка неверного API ключа
try {
    $apiInfo = $client->user->getApiKeyInfo();
} catch (InvalidApiKeyException $e) {
    echo "Неверный API ключ\n";
    // Можно попросить пользователя проверить ключ
    echo "Пожалуйста, проверьте правильность API ключа\n";
}

// Обработка ошибок валидации
try {
    $film = Film::fromArray(['invalid' => 'data']);
} catch (KpValidationException $e) {
    echo "Ошибка валидации: {$e->getMessage()}\n";
    // Можно показать пользователю, какие поля некорректны
}

public function getMessage(): string

public function getCode(): int

public function getFile(): string

public function getLine(): int

public function getTrace(): array

public function getTraceAsString(): string

public function getPrevious(): ?Throwable