php/yii2
1
0
Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-11-01 20:19:42 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
yii2/docs/guide-ru/rest-error-handling.md
Vadim Belorussov 4b5a66ad24 Translated rest-error-handling.md into Russian
2014-08-14 14:03:23 +05:00

3.8 KiB
Raw Blame History

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

Если при обработке запроса к RESTful API в запросе пользователя обнаруживается ошибка или происходит что-то непредвиденное на сервере, вы можете просто выбрасывать исключение, чтобы уведомить пользователя о нештатной ситуации. Если же вы можете установить конкретную причину ошибки (например, запрошенный ресурс не существует), вам следует подумать о том, чтобы выбрасывать исключение с соответствующим кодом состояния HTTP (например, yii\web\NotFoundHttpException, соответствующее коду состояния 404). Yii отправит ответ с соответствующим HTTP-кодом и текстом. Он также включит в тело ответа сериализованное представление исключения. Например:

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

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

Сводный список кодов состояния HTTP, используемых REST-фреймворком Yii:

  • 200: OK. Все сработало именно так, как и ожидалось.
  • 201: Ресурс был успешно создан в ответ на POST-запрос. Заголовок Location содержит URL, указывающий на только что созданный ресурс.
  • 204: Запрос обработан успешно, и в ответе нет содержимого (для запроса DELETE, например).
  • 304: Ресурс не изменялся. Можно использовать закэшированную версию.
  • 400: Неверный запрос. Может быть связано с разнообразными проблемами на стороне пользователя, такими как неверные JSON-данные в теле запроса, неправильные параметры действия, и т.д.
  • 401: Аутентификация завершилась неудачно.
  • 403: Аутентифицированному пользователю не разрешен доступ к указанной точке входа API.
  • 404: Запрошенный ресурс не существует.
  • 405: Метод не поддерживается. Сверьтесь со списком поддерживаемых HTTP-методов в заголовке Allow.
  • 415: Неподдерживаемый тип данных. Запрашивается неправильный тип данных или номер версии.
  • 422: Проверка данных завершилась неудачно (в ответе на POST-запрос, например). Подробные сообщения об ошибках смотрите в теле ответа.
  • 429: Слишком много запросов. Запрос отклонен из-за превышения ограничения частоты запросов.
  • 500: Внутренняя ошибка сервера. Возможная причина — ошибки в самой программе.