Обработка TypeError в PHP: практические решения

Расширенные примеры обработки TypeError в PHP

Покажем более сложные сценарии, включающие union-типы, nullable, методы классов и конструкторы.

Пример 1: Обработка TypeError с union-типами (PHP 8+)

Функция принимает int|string. Если передать array, будет TypeError.

<?php
declare(strict_types=1);

function process(int|string $input): void {
    echo "Обработан: $input";
}

try {
    process([1,2,3]); // TypeError: process(): Argument #1 ($input) must be of type int|string, array given
} catch (TypeError $e) {
    echo 'Ошибка: ' . $e->getMessage();
}
?>

Ошибка: process(): Argument #1 ($input) must be of type int|string, array given

Пример 2: TypeError в конструкторе класса

Класс с типизированными свойствами. Неправильный тип при создании объекта вызывает TypeError.

<?php
class User {
    public function __construct(
        public readonly string $name,
        public readonly int $age
    ) {}
}

try {
    $user = new User('John', 'thirty'); // TypeError: User::__construct(): Argument #2 ($age) must be of type int, string given
} catch (TypeError $e) {
    echo 'Не удалось создать пользователя: ' . $e->getMessage();
}
?>

Не удалось создать пользователя: User::__construct(): Argument #2 ($age) must be of type int, string given

Пример 3: Обработка ошибки типа при возврате значения

Функция объявлена с возвращаемым типом int, но возвращает строку. TypeError вылетает при попытке возврата.

<?php
declare(strict_types=1);

function getNumber(): int {
    return 'not a number'; // TypeError возвращается сразу
}

try {
    $num = getNumber();
} catch (TypeError $e) {
    echo 'Ошибка возвращаемого типа: ' . $e->getMessage();
}
?>

Ошибка возвращаемого типа: getNumber(): Return value must be of type int, string returned

Пример 4: Централизованная обработка с сохранением контекста

Использование set_exception_handler вместе с логированием в файл и показом пользователю понятного сообщения.

<?php
set_exception_handler(function (Throwable $e) {
    $logEntry = date('Y-m-d H:i:s') . ' - ' . $e->__toString();
    file_put_contents('error.log', $logEntry, FILE_APPEND);
    http_response_code(500);
    echo 'Произошла внутренняя ошибка. Пожалуйста, попробуйте позже.';
});

declare(strict_types=1);

function fetchData(int $id): string {
    return "Data for $id";
}

fetchData('abc'); // TypeError будет перехвачена обработчиком
?>

В файл error.log запишется полная информация об исключении, а пользователь увидит сообщение без технических деталей.

Пример 5: Использование is_* функций для безопасной передачи аргументов в класс

Перед вызовом конструктора проверяем типы и выбрасываем собственное исключение с понятным текстом.

<?php
class Rectangle {
    public function __construct(
        public readonly float $width,
        public readonly float $height
    ) {}
}

function createRectangle(mixed $w, mixed $h): ?Rectangle {
    if (!is_float($w) || !is_float($h)) {
        throw new InvalidArgumentException('Ширина и высота должны быть числами с плавающей точкой.');
    }
    return new Rectangle($w, $h);
}

try {
    $rect = createRectangle(10.5, '20.0'); // строка, будет выброшено исключение
} catch (InvalidArgumentException $e) {
    echo $e->getMessage();
}
?>

Ширина и высота должны быть числами с плавающей точкой.