Yii2快速构建RESTful Web服务功能简介
Yii2相比Yii1而言,一个重大的改进是内置了功能完备的RESTful支持。
其内置RESTful支持提供了如下功能:
- 使用ActiveRecord的通用接口来快速构建原型;
- 应答格式协商(缺省支持 JSON 和 XML);
- 可定制的对象序列化,支持选择输出哪些列;
- 请求数据的格式化以及验证错误;
- 通过HTTP 动词映射实现高效路由;
- 支持 OPTIONS 和 HEAD 动词;
- 认证 和 鉴权;
- 支持 HATEOAS(RESTful的架构约束,超媒体即应用程序状态);
- 结果缓存,可使用 yii\filters\HttpCache 缓存;
- 访问速率限制,避免恶意攻击和服务滥用;
- 搜索和过滤:
- 内置数据分页功能;
- API版本控制。
这些功能如果都是自己来实现,且还要有良好的扩展性、定制性,
还是要花费不少精力的,不过好在Yii2已经都很好的实现了并且还很容易进行扩展。
下面是一些功能的简单介绍:
Yii2中可定制输出变得很简单,比如想输出某些列或排除某些列,只需要简单的覆盖(override)活动记录的fields方法即可。
Yii2中对API版本控制的支持结合了业界流行的两种方式,一种为在URL中嵌入版本号(如http://api.techbrood.com/v1/users),一种是在HTTP Accept头中指定。
Yii2以前者支持大版本,而以后者支持小版本号。这样可以在简化代码、代码分离和复用之间达成较好的平衡。
Yii2中的安全机制支持3种方式,HTTP BASIC AUTH,查询参数(即在URL参数中包含访问令牌)和 开源协议 OAUTH2。
下面使用最少的语句来实现一个用户(User)资源的完整Web服务:
首先,创建一个控制器类 app\controllers\UserController
:
namespace app\controllers; use yii\rest\ActiveController; class UserController extends ActiveController { public $modelClass = ‘app\models\User‘; }
然后,修改config中的 urlManager 配置项:
‘urlManager‘ => [ ‘enablePrettyUrl‘ => true, ‘enableStrictParsing‘ => true, ‘showScriptName‘ => false, ‘rules‘ => [ [‘class‘ => ‘yii\rest\UrlRule‘, ‘controller‘ => ‘user‘], ], ]
这样就行了!你可以在你的浏览器中试着访问下:http://localhost/users。
这只是用户列表接口,Yii2实际自动帮你创建了一整套接口:
完整功能请查阅Yii2中文指南RESTful部分:Yii2 中文权威指南
by iefreer
郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。