## Наследование исключений

Пользовательский класс исключения определяют путём расширения встроенного класса Exception. Ниже показаны методы и свойства класса Exception, которые доступны дочерним классам.

Пример #1 Встроенный класс Exception

    <?php

    class Exception implements Throwable
    {
        protected $message = 'Unknown exception';   // Сообщение исключения
        private   $string;                          // Кеш метода __toString
        protected $code = 0;                        // Пользовательский код исключения
        protected $file;                            // Файл, в котором код выбросил исключение
        protected $line;                            // Строка, в которой код выбросил исключение
        private   $trace;                           // Трассировка вызовов методов и функций
        private   $previous;                        // Предыдущее исключение, если исключение вложенное

        public function __construct($message = '', $code = 0, ?Throwable $previous = null);

        final private function __clone();           // Запрещает клонирования исключения

        final public  function getMessage();        // Сообщение исключения
        final public  function getCode();           // Код исключения
        final public  function getFile();           // Файл, в котором код выбросил исключение
        final public  function getLine();           // Строка, на которой код выбросил исключение
        final public  function getTrace();          // Массив функции backtrace()
        final public  function getPrevious();       // Предыдущее исключение
        final public  function getTraceAsString();  // Отформатированная строка трассировки

        // Переопределяемый
        public function __toString();               // Отформатированная строка для отображения
    }

В конструкторе класса-наследника нужно также вызвать конструктор родительского класса — parent::__construct(), когда класс расширяет класс Exception и переопределяет конструктор, чтобы гарантировать, что родительский класс правильно присвоил значения доступным данным. Метод __toString() допустимо переопределять, чтобы настроить пользовательский вывод, когда с объектом исключения работают как со строкой.

> Замечание:

> Исключения нельзя клонировать. Попытка клонировать исключение приведёт к фатальной ошибке `E_ERROR`.

Пример #2 Наследование класса Exception

    <?php

    /**
     * Определим класс исключения
     */
    class MyException extends Exception
    {
        // Переопределим исключение так, что параметр message станет обязательным
        public function __construct($message, $code = 0, ?Throwable $previous = null)
        {
            // Какой-то код

            // Убедимся, что родительский класс правильно присвоил значения
            parent::__construct($message, $code, $previous);
        }

        // Переопределим строковое представление объекта
        public function __toString()
        {
            return __CLASS__ . ": [{$this->code}]: {$this->message}\n";
        }

        public function customFunction()
        {
            echo "Пользовательская функция для этого типа исключения\n";
        }
    }

    /**
     * Создадим класс для тестирования исключения
     */
    class TestException
    {
        public $var;

        const THROW_NONE    = 0;
        const THROW_CUSTOM  = 1;
        const THROW_DEFAULT = 2;

        function __construct($avalue = self::THROW_NONE)
        {

            switch ($avalue) {
                case self::THROW_CUSTOM:
                    // Выбрасываем своё исключение
                    throw new MyException('1 — неправильный параметр', 5);
                    break;

                case self::THROW_DEFAULT:
                    // Выбрасываем встроенное исключение
                    throw new Exception('2 — недопустимый параметр', 6);
                    break;

                default:
                    // Без исключения, PHP создаст объект
                    $this->var = $avalue;
                    break;
            }
        }
    }

    echo "# Пример 1\n";
    try {
        $o = new TestException(TestException::THROW_CUSTOM);
    } catch (MyException $e) {      // Перехватится
        echo "Блок catch перехватил пользовательское переопределённое исключение\n", $e;
        $e->customFunction();
    } catch (Exception $e) {        // Пропускается
        echo "Поймано встроенное исключение\n", $e;
    }

    // Продолжить выполнение
    var_dump($o); // Null

    echo "\n\n# Пример 2\n";
    try {
        $o = new TestException(TestException::THROW_DEFAULT);
    } catch (MyException $e) {      // Тип исключения не совпадёт
        echo "Блок catch перехватил пользовательское переопределённое исключение\n", $e;
        $e->customFunction();
    } catch (Exception $e) {        // Перехватится
        echo "Блок catch перехватил встроенное исключение\n", $e;
    }

    // Продолжить выполнение
    var_dump($o); // Null

    echo "\n\n# Пример 3\n";
    try {
        $o = new TestException(TestException::THROW_CUSTOM);
    } catch (Exception $e) {        // Перехватится
        echo "Блок catch перехватил встроенное исключение\n", $e;
    }

    // Продолжить выполнение
    var_dump($o); // Null

    echo "\n\n# Пример 4\n";
    try {
        $o = new TestException();
    } catch (Exception $e) {        // Пропускается, поскольку исключение не выбрасывается
        echo "Блок catch перехватил встроенное исключение\n", $e;
    }

    // Продолжить выполнение
    var_dump($o); // TestException

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open