yii2/docs/guide-ru/runtime-handling-errors.md

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

<<<<<<< HEAD

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

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

use yii\base\ErrorException;
use Yii;
=======
В состав Yii входит встроенный [[yii\web\ErrorHandler|обработчик ошибок]], делающий работу с ошибками гораздо более
приятным занятием. А именно:

* Все нефатальные ошибки PHP (то есть warning, notice) конвертируются в исключения, которые можно перехватывать.
* Исключения и фатальные ошибки PHP отображаются в режиме отладки с детальным стеком вызовов и исходным кодом.
* Можно использовать для отображения ошибок [действие контроллера](structure-controllers.md#actions).
* Поддерживаются различные форматы ответа.

По умолчанию [[yii\web\ErrorHandler|обработчик ошибок]] включен. Вы можете выключить его объявив константу
`YII_ENABLE_ERROR_HANDLER` со значением false во [входном скрипте](structure-entry-scripts.md) вашего приложения.


## Использование обработчика ошибок <span id="using-error-handler"></span>

[[yii\web\ErrorHandler|Обработчик ошибок]] регистрируется в качестве [компонента приложения](structure-application-components.md)
с именем `errorHandler`. Вы можете настраивать его следующим образом:

```php
return [
    'components' => [
        'errorHandler' => [
            'maxSourceLines' => 20,
        ],
    ],
];

С приведённой выше конфигурацией на странице ошибки будет отображаться до 20 строк исходного кода.

Как уже было упомянуто, обработчик ошибок конвертирует все нефатальные ошибки PHP в перехватываемые исключения. Это означает что можно поступать с ошибками следующим образом:

use Yii;
use yii\base\ErrorException;
>>>>>>> yiichina/master

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

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

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

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

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

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

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

Если вам необходимо показать пользователю страницу с ошибкой, говорящей ему о том, что его запрос не верен или не должен был быть сделан, вы можете выкинуть yii\web\HttpException, такое как yii\web\NotFoundHttpException. Обработчик ошибок корректно выставит статус код HTTP для ответа и использует подходящий вид страницы ошибки.

use yii\web\NotFoundHttpException;
 
throw new NotFoundHttpException();

Настройка отобажения ошибок

yii\web\ErrorHandler меняет отображение ошибок в зависимости от значения константы YII_DEBUG. При YII_DEBUG равной true (режим отладки), обработчик ошибок будет отображать для облегчения отладки детальный стек вызовов и исходный код. При YII_DEBUG равной false отображается только сообщение об ошибке, тем самым не позволяя получить информацию о внутренностях приложения.

Информация: Если исключение является наследником yii\base\UserException, стек вызовов не отображается вне зависимости от значения YII_DEBUG так как такие исключения считаются ошибками пользователя и исправлять что-либо разработчику не требуется.

По умолчанию yii\web\ErrorHandler показывает ошибки используя два представления:

• @yii/views/errorHandler/error.php: используется для отображения ошибок БЕЗ стека вызовов. При YII_DEBUG равной false используется только это преставление.
• @yii/views/errorHandler/exception.php: используется для отображения ошибок СО стеком вызовов.

Вы можете настроить свойства yii\web\ErrorHandler::errorView и yii\web\ErrorHandler::exceptionView для того, чтобы использовать свои представления.

Использование действий для отображения ошибок

Лучшим способом изменения отображения ошибок является использование действий путём конфигурирования свойства yii\web\ErrorHandler::errorAction компонента errorHandler:

yiichina/master

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

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

Свойство yii\web\ErrorHandler::errorAction принимает маршрут действия. Конфигурация выше означает, что для отображения ошибки без стека вызовов будет использовано действие site/error.

Само действие можно реализовать следующим образом:

namespace app\controllers;

use Yii;
use yii\web\Controller;

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

Приведённый выше код задаёт действие error используя класс yii\web\ErrorAction, который рендерит ошибку используя отображение error.

Вместо использования yii\web\ErrorAction вы можете создать действие error как обычный метод:

yiichina/master

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

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

• statusCode: HTTP статус (например, 403, 500). Доступен только для yii\web\HttpException.
• 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 имеет те же свойства, которые были указаны ранее.

Вы должны создать файл представления views/site/error.php. В этом файле, если используется yii\web\ErrorAction, вам доступны следующие переменные:

• name: имя ошибки;
• message: текст ошибки;
• exception: объект исключения, из которого можно получить дополнительную информацию, такую как статус HTTP, код ошибки, стек вызовов и т.д.

Информация: Если вы используете шаблоны приложения basic или advanced, действие error и файл представления уже созданы за вас.

Изменение формата ответа

Обработчик ошибок отображает ошибки в соответствии с выбранным форматом ответа. Если yii\web\Response::format задан как html, будут использованы представления для ошибок и исключений, как описывалось ранее. Для остальных форматов ответа обработчик ошибок присваивает массив данных, представляющий ошибку свойству yii\web\Response::data. Оно далее конвертируется в необходимый формат. Например, если используется формат ответа json, вы получите подобный ответ:

HTTP/1.1 404 Not Found
Date: Sun, 02 Mar 2014 05:31:43 GMT
Server: Apache/2.2.26 (Unix) DAV/2 PHP/5.4.20 mod_ssl/2.2.26 OpenSSL/0.9.8y
Transfer-Encoding: chunked
Content-Type: application/json; charset=UTF-8

{
    "name": "Not Found Exception",
    "message": "The requested resource was not found.",
    "code": 0,
    "status": 404
}

Изменить формат можно в обработчике события beforeSend компонента response в конфигурации приложения:

return [
    // ...
    'components' => [
        'response' => [
            'class' => 'yii\web\Response',
            'on beforeSend' => function ($event) {
                $response = $event->sender;
                if ($response->data !== null) {
                    $response->data = [
                        'success' => $response->isSuccessful,
                        'data' => $response->data,
                    ];
                    $response->statusCode = 200;
                }
            },
        ],
    ],
];

Приведённый код изменит формат ответа на подобный:

HTTP/1.1 200 OK
Date: Sun, 02 Mar 2014 05:31:43 GMT
Server: Apache/2.2.26 (Unix) DAV/2 PHP/5.4.20 mod_ssl/2.2.26 OpenSSL/0.9.8y
Transfer-Encoding: chunked
Content-Type: application/json; charset=UTF-8

{
    "success": false,
    "data": {
        "name": "Not Found Exception",
        "message": "The requested resource was not found.",
        "code": 0,
        "status": 404
    }
}

yiichina/master