首页 > 代码库 > Yii2快速构建RESTful Web服务功能简介

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 auto-generated restful interfaces

完整功能请查阅Yii2中文指南RESTful部分:Yii2 中文权威指南


by iefreer