🚨 Ошибки и исключения
В PHP живут две системы ошибок сразу: исключения, которые ловятся try/catch, и старые warning и notice, которые просто печатаются и не останавливают код. Плюс фатальные ошибки, которые не ловятся ничем. Интервьюер по этой теме проверяет одно: поймёшь ли ты, почему сервис отдал пустую страницу и ничего не записал в лог
🧠 Как это устроено
Throwable, Error и Exception
Всё, что можно бросить и поймать, реализует интерфейс Throwable. Реализовать его напрямую нельзя, у него ровно две ветки:
Error— ошибки движка и языка. Их бросает сам PHP: вызов метода уnull, неизвестная функция, неверный тип аргумента, деление на ноль. Это почти всегда баг в коде, а не ситуация, которую программа должна пережитьException— ошибки, которые предусмотрел разработчик: не нашли заказ, внешний API ответил 500, пользователь прислал кривой JSON. Свои исключения наследуют отсюда
Внутри Error полезно помнить четыре класса:
| Класс | Когда бросается | Пример |
|---|---|---|
TypeError | аргумент или возвращаемое значение не того типа | strlen([]) |
ArgumentCountError | функции передали не то число аргументов, наследник TypeError | strlen() |
ValueError | тип верный, значение недопустимое | str_repeat('x', -1) |
DivisionByZeroError | деление или остаток от деления на ноль, наследник ArithmeticError | 1 % 0, intdiv(1, 0) |
С PHP 8 1 / 0 тоже бросает DivisionByZeroError, а в PHP 7 давал warning и INF. Это общая линия последних версий: то, что раньше было warning или фатальной ошибкой, становится Error, и его можно поймать
У Exception есть стандартные наследники из SPL. Делятся они по смыслу:
LogicException— ошибка в самой программе, которую надо исправлять кодом. Сюда входятInvalidArgumentException,DomainException,LengthException,OutOfRangeExceptionRuntimeException— то, что видно только во время работы: сеть, файл, данные из базы. Наследники: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в контексте