В каких случаях следует делать кастомные Exceptions?

Question

[Роми]

Углубившись в тему исключений :) озадачился вот каким вопросом:

- В каких случаях может понадобиться создание собственных исключений?

Ведь уже есть достаточно много готовых и в SPL, и в фреймворках?

Какое веское основание может быть для создания собственного исключения?

Answer 1

[Flying]

Собственные исключения необходимы в случаях, когда вы хотите обрабатывать (или, в случае если вы автор библиотеки - предоставить возможности обработки) какой-либо исключительный сценарий специальным образом. К примеру посмотрите, как организована работа с exceptions в Doctrine.

Также собственные исключения могут пригодится в случае, если вы хотите передавать с этим исключением какую-то дополнительную информацию. К примеру посмотрите на exceptions для ответов разных HTTP статусов в Symfony.

Comments

[Роми]

Да, пожалуй это и есть полный ответ на вопрос. Спасибо!

[Роми]

кстати

Собственные исключения необходимы в случаях, когда вы хотите обрабатывать (или, в случае если вы автор библиотеки - предоставить возможности обработки) какой-либо исключительный сценарий специальным образом.

я правильно понял, что это вроде хуков получается? :) ну, таких, своеобразных ))

[Flying]

Роми, Нет, аналогия с хуками здесь не подходит.

Exception по своему определению - это механизм прерывания потока выполнения программы и "экстренное всплытие" по стеку вызовов. Хуки же - возможность врезать свою логику в какое-то определённое место программы, но они не меняют поток выполнения и уж точно не вызывают всплытия по стеку, если конечно там внутри не кинуть тот же exception.

В данном случае цель - предоставить больше информации и возможности различной обработки.

Возьмём, к примеру, набор exceptions для Symfony Mailer.

Там есть например TransportException и InvalidArgumentException.

Очевидно, что в случае TransportException само письмо может быть отправлено, просто это не получилось сделать вот прямо сейчас. А в случае InvalidArgumentException видимо что-то не так в нашем коде и попытка отправить это же письмо ещё раз, очевидно, будет провальной.

Поэтому в данном случае раздельная обработка этих исключений позволит улучшить работу приложения:

try {
    // пытаемся отправить письмо
} catch (TransportException $e) {
    // откладываем отправку письма на попозже
} catch (InvalidArgumentException $e) {
    // что-то не так, пишем в логи и прерываем попытки выслать письмо
}

Довольно логично что это лучше, чем единообразная обработка.

[Роми]

Flying, весьма доходчиво. Огромное спасибо!

Answer 2

[Barmunk]

Можно делать глобальные обработки Exceptions. Более наглядный стак трейс.

К примеру библиотека для валидации телефонного номера:
https://github.com/Propaganistas/Laravel-Phone/tre...
CountryCodeException.php
InvalidParameterException.php
NumberFormatException.php
NumberParseException.php

Comments

[Роми]

спасибо за пример

Answer 3

[catanfa]

Мы делаем кастомные исключения во всех случаях. Просто для читабельности, передачи контекста, исключения дебатов во время код-ревью - делать кастомное исключение или нет, и т.д.