Обработка ошибок

Раздел в разработке.

Обработка ошибок в Yii происходит несколько иначе, чем в обычном PHP. Во-первых, все нефатальные ошибки в Yii преобразуются в исключения:

use yii\base\ErrorException;
use Yii;

try {
    10/0;
} catch (ErrorException $e) {
    Yii::warning("Попытка деления на ноль.");
}

// можно продолжать выполнение

Как это видно из примера, вы можете обрабатывать ошибки, используя конструкцию try-catch.

Во-вторых, даже фатальные ошибки в Yii показываются в красивом виде. Это значит, что при отладке кода, вы можете отслеживать причины фатальных ошибок. Это позволяет быстрее находить причины возникших проблем.

Рендеринг ошибок в произвольном действии контроллера

Обычная страница вывода ошибок Yii не только хороша в разработке, но и приемлема для уже развернутых проектов, если YII_DEBUG выключена в начальном загрузочном скрипте index.php. Но иногда хочется изменить внешний вид страницы с ошибками, чтобы лучше приспособить ее под свой проект.

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

// ...
'components' => [
    // ...
    'errorHandler' => [
        'errorAction' => 'site/error',
    ],
]

С вышеуказанной конфигурацией, если происходит ошибка, Yii запустит действие error контроллера site. Это действие запрашивает у компонента errorHandler, было ли выброшено исключение, и, если да, отображает соответствующий вид, передавая ему объект исключения в качестве параметра.

public function actionError()
{
    $exception = \Yii::$app->errorHandler->exception;
    if ($exception !== null) {
        return $this->render('error', ['exception' => $exception]);
    }
}

После создания action нужно создать соответствующий вид, который и будет отображать информацию об исключении. Объект исключения, передаваемый в вид, имеет следующие свойства:

• statusCode: HTTP статус (например, 403, 500). Доступен только для [[yii\web\HttpException|HTTP exceptions]].
• code: код исключения.
• message: сообщение об ошибке.
• file: имя файла PHP скрипта, в котором произошла ошибка.
• line: номер строки в коде, где произошла ошибка.
• trace: стэк вызовов, приведших к ошибке.

Рендеринг ошибок без создания отдельного действия

Вместо создания отдельного действия внутри контроллера Site, вы можете просто указать Yii какой класс использовать для обработки ошибок:

public function actions()
{
    return [
        'error' => [
            'class' => 'yii\web\ErrorAction',
        ],
    ];
}

После задания вышеуказанной связки ошибки с классом обработчиком, создайте вид views/site/error.php, который будет использоваться автоматически. Виду передаются три параметра:

• $name: название ошибки
• $message: сообщение об ошибке
• $exception: обрабатываемое исключение

Объект $exception имеет те же свойства, которые были указаны ранее.