К содержимому
Войти

PHP Road Map

🚨 Ошибки и исключения

В PHP живут две системы ошибок сразу: исключения, которые ловятся try/catch, и старые warning и notice, которые просто печатаются и не останавливают код. Плюс фатальные ошибки, которые не ловятся ничем. Интервьюер по этой теме проверяет одно: поймёшь ли ты, почему сервис отдал пустую страницу и ничего не записал в лог

🧠 Как это устроено

Throwable, Error и Exception

Всё, что можно бросить и поймать, реализует интерфейс Throwable. Реализовать его напрямую нельзя, у него ровно две ветки:

  • Error — ошибки движка и языка. Их бросает сам PHP: вызов метода у null, неизвестная функция, неверный тип аргумента, деление на ноль. Это почти всегда баг в коде, а не ситуация, которую программа должна пережить
  • Exception — ошибки, которые предусмотрел разработчик: не нашли заказ, внешний API ответил 500, пользователь прислал кривой JSON. Свои исключения наследуют отсюда

Внутри Error полезно помнить четыре класса:

КлассКогда бросаетсяПример
TypeErrorаргумент или возвращаемое значение не того типаstrlen([])
ArgumentCountErrorфункции передали не то число аргументов, наследник TypeErrorstrlen()
ValueErrorтип верный, значение недопустимоеstr_repeat('x', -1)
DivisionByZeroErrorделение или остаток от деления на ноль, наследник ArithmeticError1 % 0, intdiv(1, 0)

С PHP 8 1 / 0 тоже бросает DivisionByZeroError, а в PHP 7 давал warning и INF. Это общая линия последних версий: то, что раньше было warning или фатальной ошибкой, становится Error, и его можно поймать

У Exception есть стандартные наследники из SPL. Делятся они по смыслу:

  • LogicException — ошибка в самой программе, которую надо исправлять кодом. Сюда входят InvalidArgumentException, DomainException, LengthException, OutOfRangeException
  • RuntimeException — то, что видно только во время работы: сеть, файл, данные из базы. Наследники: UnexpectedValueException, OutOfBoundsException, OverflowException, UnderflowException

catch (Exception $e) не поймает TypeError, потому что это другая ветка. Чтобы поймать вообще всё, пишут catch (Throwable $e), и делают это в одном месте, в обработчике верхнего уровня

Warning, notice и error_reporting

Обращение к несуществующему ключу массива или неопределённой переменной не бросает исключение. PHP выдаёт warning, печатает его и идёт дальше со значением null. В PHP 8 оба случая — E_WARNING, в PHP 7 это был E_NOTICE. Ещё есть E_DEPRECATED: так новая версия предупреждает, что конструкция скоро перестанет работать

Что делать с такими сообщениями, решают три настройки:

  • error_reporting — какие уровни вообще учитываются. С PHP 8 по умолчанию E_ALL, раньше notice и deprecated в него не входили
  • display_errors — печатать ли ошибку в ответ. В php.ini-production он Off, и на проде так и должно быть: текст ошибки с путями к файлам и кусками SQL не должен уходить пользователю
  • log_errors и error_log — писать ли в лог и куда. На проде On, иначе ошибки просто исчезают

set_error_handler и ErrorException

Warning, который никто не видит, — это тихий баг: код отработал на null и записал в базу мусор. Поэтому почти все фреймворки ставят свой обработчик через set_error_handler и превращают warning в ErrorException. После этого опечатка в ключе массива роняет запрос с понятным стектрейсом, а не портит данные

Обработчик вызывается на любую ошибку, даже подавленную через @ или выключенную в error_reporting. Поэтому первой строкой он проверяет error_reporting() & $severity и возвращает false, если ошибку надо пропустить. false значит «пусть дальше работает стандартный обработчик PHP». Deprecation в исключение обычно не превращают: после обновления PHP приложение упадёт на первом же устаревшем вызове в чужой библиотеке

Перехватить так можно не всё. E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR и их warning-варианты до пользовательского обработчика не доходят

Необработанные исключения и фатальные ошибки

Исключение, которое никто не поймал, попадает в set_exception_handler. Это последний шанс записать его в лог и отдать аккуратную страницу 500. После обработчика скрипт завершается, вернуться в код уже нельзя

Настоящие фатальные ошибки не ловит ни catch (Throwable), ни set_error_handler. Это нехватка памяти (Allowed memory size exhausted), превышение max_execution_time, ошибка компиляции. Не выполняется и finally. Остаётся register_shutdown_function: функция вызывается при завершении скрипта по любой причине, а error_get_last() внутри неё вернёт последнюю ошибку. Если у неё фатальный тип, её пишут в лог

С PHP 8.5 у фатальных ошибок появился бэктрейс: раньше в логе была только строка, где закончилась память, теперь видна цепочка вызовов. Управляет этим настройка fatal_error_backtraces, по умолчанию она включена

🛠️ На практике

finally выполняется всегда, и return в нём побеждает

finally выполняется после try и catch при любом исходе: блок отработал, бросил исключение или сделал return. Туда кладут закрытие файлов, снятие блокировок, откат транзакции

Ловушка в том, что return внутри finally перебивает и результат try, и летящее исключение. Исключение пропадает молча, его не увидит ни catch выше, ни лог. Проверено на PHP 8.4:

function f(): string {
    try {
        throw new RuntimeException('упало');
    } finally {
        return 'из finally';
    }
}
echo f(); // из finally — RuntimeException исчез

function h(): int {
    $x = 1;
    try {
        return $x;
    } finally {
        $x = 2; // значение для return уже вычислено
    }
}
echo h(); // 1

Если finally сам бросит исключение, пока летит другое, наружу уйдёт новое, а старое PHP положит в его getPrevious(). Поэтому правило простое: в finally только уборка, без return и без логики, которая может упасть

Обработчик ошибок и свои исключения

PHP · Warning в ErrorException, своё исключение с previous, multi-catch

set_error_handler(function (int $severity, string $message, string $file, int $line): bool {
    if (!(error_reporting() & $severity)) {
        return false; // подавлено через @ или error_reporting
    }
    throw new ErrorException($message, 0, $severity, $file, $line);
});

try {
    $config = [];
    $port = $config['port'];
} catch (ErrorException $e) {
    echo $e->getMessage(); // Undefined array key "port"
}

final class OrderNotFound extends RuntimeException {}

function load(int $id): void {
    try {
        throw new PDOException('SQLSTATE[HY000] connection refused');
    } catch (PDOException $e) {
        // своё исключение для вызывающего кода, исходная причина не теряется
        throw new OrderNotFound("Заказ $id не загрузился", previous: $e);
    }
}

try {
    load(42);
} catch (OrderNotFound $e) {
    echo $e->getMessage(), ' <- ', $e->getPrevious()->getMessage();
    // Заказ 42 не загрузился <- SQLSTATE[HY000] connection refused
}

try {
    throw new InvalidArgumentException('bad id');
} catch (InvalidArgumentException|DomainException $e) { // multi-catch, с PHP 7.1
    echo get_class($e);
}

try {
    throw new LogicException('x');
} catch (LogicException) { // без переменной, с PHP 8.0
    echo 'поймали';
}

Цепочка previous нужна, когда исключение переводят на язык своего слоя. Репозиторий не должен отдавать контроллеру PDOException, но и терять его нельзя: в логе потом будет видно и «заказ не загрузился», и настоящую причину. Логгеры и фреймворки выводят всю цепочку сами

Фатальная ошибка и shutdown-функция

register_shutdown_function(function (): void {
    $err = error_get_last();
    $fatal = [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR];
    if ($err !== null && in_array($err['type'], $fatal, true)) {
        error_log("fatal: {$err['message']} in {$err['file']}:{$err['line']}");
    }
});

ini_set('memory_limit', '8M');
try {
    $a = [];
    while (true) { $a[] = str_repeat('x', 1024); }
} catch (Throwable $e) {
    echo 'сюда не попадём';
} finally {
    echo 'и сюда тоже';
}

На PHP 8.4 этот код не напечатает ни одной строки из catch и finally, сработает только shutdown-функция с сообщением Allowed memory size of 8388608 bytes exhausted. На PHP 8.5 под таким сообщением в логе появляется блок Stack trace: с пронумерованными кадрами, как у необработанного исключения. Аргументы в нём скрываются по тем же правилам, что и в стектрейсе исключений: настройка zend.exception_ignore_args и атрибут #[\SensitiveParameter]. Не хочешь видеть пути и вызовы в логах — выключи fatal_error_backtraces

Где ловить в веб-приложении

Ловить исключение стоит там, где с ним можно что-то сделать: повторить запрос к API, вернуть 404 вместо 500, подставить значение по умолчанию. Остальное пусть летит наверх, до обработчика фреймворка. В Laravel это withExceptions в bootstrap/app.php, в Symfony — событие kernel.exception. Обработчик пишет в лог, решает, какой статус отдать, и прячет детали от пользователя

try/catch (Throwable) вокруг всего контроллера — плохая замена. Он глотает ошибку, часто отдаёт 200 с пустым телом, и стектрейс теряется

Логируют через PSR-3 (Psr\Log\LoggerInterface, на практике Monolog). Сообщение пишут одной короткой строкой с плейсхолдерами, а само исключение кладут в контекст с ключом exception:

$this->logger->error('Не загрузился заказ {orderId}', [
    'orderId' => $id,
    'exception' => $e,
]);

Так в логе одна запись, по которой можно искать и группировать, а стектрейс и цепочка previous лежат в отдельном поле. Склеивать $e->getMessage() и $e->getTraceAsString() в строку сообщения не нужно: каждая ошибка получит уникальный текст, и сгруппировать их уже не выйдет

⚠️ Где ошибаются

  • Ловят Exception и думают, что поймали всё. TypeError от передачи null в типизированный параметр пролетит мимо. Наверху ловят Throwable, в бизнес-коде — конкретные классы
  • Пустой catch. catch (Exception $e) {} превращает ошибку в тихий баг, который найдут через месяц по жалобам пользователей. Не знаешь, что делать с исключением, — не лови его
  • return в finally. Перебивает исключение, и оно исчезает без следа. Проверено запуском выше
  • display_errors = On на проде. Пользователь видит в тексте ошибки пути к файлам, имена таблиц и куски SQL. На проде Off и log_errors = On
  • Теряют причину при оборачивании. throw new OrderNotFound('...') без previous: $e оставляет в логе только верхний слой, и до упавшего запроса к базе уже не докопаться
  • Подавляют через @. @file_get_contents($url) прячет и ожидаемую ошибку, и все неожиданные. Лучше проверить результат на false и вызвать error_get_last() или взять HTTP-клиент, который бросает исключения

🎯 Вопросы с собеседований

Чем отличаются Throwable, Error и Exception?

Throwable — общий интерфейс всего, что можно бросить и поймать, у него две ветки. Error бросает сам движок: неверный тип, неизвестная функция, вызов метода у null, деление на ноль. Это баги, их исправляют кодом, а не обрабатывают. Exception — ошибки, которые предусмотрел разработчик, от него наследуют свои исключения. catch (Exception) не поймает TypeError, поэтому обработчик верхнего уровня ловит Throwable

Что выполняется в finally и что будет, если в нём сделать return?

finally выполняется при любом выходе из try: блок отработал, бросил исключение или вернул значение. Если в finally есть return, он перебивает результат try и летящее исключение: исключение пропадает молча. Если finally бросит своё исключение, оно уйдёт наружу, а исходное будет в getPrevious(). Не выполнится finally при фатальной ошибке вроде нехватки памяти и при exit(): скрипт останавливается сразу

Как поймать фатальную ошибку?

catch её не поймает, set_error_handler тоже: E_ERROR, E_PARSE, E_COMPILE_ERROR до него не доходят. Работает register_shutdown_function: функция вызывается при любом завершении скрипта, внутри неё error_get_last() возвращает последнюю ошибку, и если тип фатальный, её пишут в лог или отправляют в Sentry. Исправить что-то уже нельзя, только зафиксировать. С PHP 8.5 у фатальных ошибок в логе есть бэктрейс, это настройка fatal_error_backtraces

Зачем превращать warning в ErrorException?

Warning не останавливает код: опечатка в ключе массива даёт null, и скрипт идёт дальше с неверными данными. set_error_handler, который бросает ErrorException, превращает такой warning в исключение со стектрейсом, и запрос падает сразу, а не пишет мусор в базу. Laravel и Symfony делают это из коробки. В обработчике проверяют error_reporting() & $severity, чтобы уважать @ и настройки, а deprecation обычно только логируют

Когда наследовать своё исключение от LogicException, а когда от RuntimeException?

LogicException — ошибка программиста, которую видно без запуска: передали отрицательный лимит, вызвали метод в неверном состоянии. Её исправляют кодом. RuntimeException — то, что зависит от внешнего мира: заказа нет в базе, API не ответил, файл занят. Её обрабатывают: повторяют, показывают пользователю, отдают 404. Своему исключению стоит дать понятное имя вроде OrderNotFound и пробрасывать исходную причину через previous

📚 Что почитать

  • Throwable в руководстве PHP — интерфейс и вся иерархия встроенных классов
  • Исключения SPL — какие классы есть в ветках LogicException и RuntimeException
  • set_error_handler — какие уровни нельзя перехватить и что значит возврат false
  • Настройки ошибок — display_errors, log_errors и fatal_error_backtraces с значениями по умолчанию
  • PSR-3 — интерфейс логгера, плейсхолдеры и ключ exception в контексте