阅读前篇简介Yii 是什么从 Yii 1.1 升级入门安装 Yii运行应用第一次问候使用Forms数据库应用使用 Gii 生成代码进阶应用结构概述入口脚本应用（Applications）应用组件（Application Components）控制器（Controllers）模型（Models）视图（views）模块（Modules）过滤器（Filters）小部件（Widgets）前端资源（Assets）扩展（Extensions）请求处理运行概述启动引导（Bootstrapping）路由和创建URL请求（Requests）响应（Responses）Sessions 和 Cookies错误处理（Handling Errors）日志（Logging）关键概念组件（Component）属性（Property）事件（Events）行为（Behaviors）配置（Configurations）别名（Aliases）类自动加载（Autoloading）服务定位器（Service Locator）依赖注入容器（Dependency Injection Container）配合数据库工作数据库访问 (Data Access Objects)查询生成器（Query Builder）活动记录（Active Record）数据库迁移（Migrations）SphinxRedisMongoDBElasticsearch接收用户数据创建表单(Creating Forms)输入验证(Validating Input)文件上传(Uploading Files)收集列表输入(Collecting Tabular Input)多模型的复合表单(Getting Data for Multiple Models)显示数据格式化输出数据（Data Formatting）分页（Pagination）排序（Sorting）数据提供器（Data Providers）数据小部件（Data Widgets）客户端脚本使用(Working with Client Scripts)主题（Theming）安全认证（Authentication）授权（Authorization）处理密码（Working with Passwords）客户端认证（Auth Clients）最佳安全实践（Best Practices）缓存概述数据缓存片段缓存页面缓存HTTP 缓存RESTfull Web服务快速入门（Quick Start）资源（Resources）控制器（Controllers）路由（Routing）格式化响应（Response Formatting）授权认证（Authentication）速率限制（Rate Limiting）版本（Versioning）错误处理（Error Handling）开发工具调试工具栏和调试器使用Gii生成代码生成API文档测试概述（Overview）配置测试环境（Testing environment setup）单元测试（Unit Tests）功能测试（Function Tests）验收测试（Acceptance Tests）测试夹具（Fixtures）高级专题高级应用模板创建自定义应用程序结构控制台命令核心验证器（Core Validators）国际化收发邮件性能优化共享主机环境模板引擎集成第三方代码小部件Bootstrap 小部件Jquery UI助手类概述Array 助手(ArrayHelper)Html 助手(Html)Url 助手(Url)
©
本文档使用
php.cn手册 发布
文字
错误处理
错误处理
处理一个 RESTful API 请求时， 如果有一个用户请求错误或服务器发生意外时， 你可以简单地抛出一个异常来通知用户出错了。 如果你能找出错误的原因 (例如，所请求的资源不存在)，你应该 考虑抛出一个适当的HTTP状态代码的异常 (例如， yii\web\NotFoundHttpException 意味着一个404 HTTP状态代码)。 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
}
下面的列表总结了Yii的REST框架的HTTP状态代码:
-
200: OK。一切正常。 -
201: 响应POST请求时成功创建一个资源。Locationheader 包含的URL指向新创建的资源。 -
204: 该请求被成功处理，响应不包含正文内容 (类似DELETE请求)。 -
304: 资源没有被修改。可以使用缓存的版本。 -
400: 错误的请求。可能通过用户方面的多种原因引起的，例如在请求体内有无效的JSON 数据，无效的操作参数，等等。 -
401: 验证失败。 -
403: 已经经过身份验证的用户不允许访问指定的 API 末端。 -
404: 所请求的资源不存在。 -
405: 不被允许的方法。 请检查Allowheader 允许的HTTP方法。 -
415: 不支持的媒体类型。 所请求的内容类型或版本号是无效的。 -
422: 数据验证失败 (例如，响应一个POST请求)。 请检查响应体内详细的错误消息。 -
429: 请求过多。 由于限速请求被拒绝。 -
500: 内部服务器错误。 这可能是由于内部程序错误引起的。