yii2框架-restful的基础入门(二十一)

今天给人的感觉就是“热,很热,热中暑”!
最近的高温天气简直让人不能活啊,听说华中地区的温度居然超过40度,广东的温度也接近37度,户外工作的真的做好避暑咯!
趁着今天工作之余,感觉总的写些什么东西。现在回想起来,自己学习编程也接近3年了,从大三开始正式学习php,当时是跟着LAMP兄弟连的老师一边看视频,一边查找资料,一边练习,做些小的模块,比如登录,分页,简单的CURD等等。到后来逐渐接触thinkphp框架,学习mvc开发模式,了解php自动注册机制,命名空间,类库,魔术方法等,自己是一直在慢慢进步,也遇到过很多的困难,也得到很多人的帮助。
现在工作一年多的时间里,在实际的项目目中,用到和学到的知识就更多,mongodb,redis,nginx,集群,ffmpeg,nodejs,angularjs,workerman,swoole,yii2框架,还有各种开源的类库或者组件等!google,百度,github,各种技术论坛,例如推酷,脚本之家,开源中国等等,这些都成为了这三年来陪伴我的伙伴。
今天想写的应该是关于yii2的restful api部分。作为一名软件研发的工程师,其实我们的项目应用中是经常做一些接口的,给第三方调用。
restful 是一种设计的规范,表述的是一种状态转移(可以自己百度了解),URI代表的是一种直观的请求资源。
当然,设计restful api 只是为了更加规范设计接口而已,并不是说一定就要按照restful的规范去设计,利用我们平常的post或者get的方式也是可以的,只是看起来并没有那么的直观明了,所以说设计的接口这个要根据自己的业务来做设计。
下面我们来了解一下设计接口一般要满足什么的条件?
(1)API的URL(或者URI)
(2)认证和授权API。必须要认证才能合法通过api访问内容
(3)传递的数据。以get或者post的方式传json类型数据或者其他类型
(4)返回的数据格式。以json数据格式返回,当然还要包括状态码,信息,返回的数据这三者
(5)api版本化。其实还会有一个很重要的额外条件就是API的版本化,这个是非常重要的。
以上5个应该是最简单的api接口条件了。
yii2的restful api 是一种规范设计的API,当然也是满足以上的4个条件的。

这是权威指南:http://www.yiichina.com/doc/guide/2.0/rest-quick-start,可以认真看看。


首先我们在yii2的高级框架中将api接口作为一个应用,也就是和fronted,backend是同级的应用。那么我们就可以在api这个应用中以模块化设计来实现版本化的设计。


简单地说,就是一个v1模块,代表v1版本,接口升级时,定义v2的模块,代表v2版本,这样子不论是v1,v2的接口都可以使用,比如一个app之前是接入v1版本接口的,现在更新的app,对应接入的v2版本接口,那么这两个app都依然可以使用,两个版本的接口都在服务。
(1)首先我们将fronted文件夹复制,并且粘贴在同一个目录下,重命名为api,那么这个api就是一个接口应用了。
接下来将api里的controllers和models这两个文件夹的所有文件都删除?为什么呢?因为这两个文件夹里面的类的命名空间是fronted开头的(因为我们是复制过来的文件)

(2)修改配置文件

在api的config的文件下面,有一个boostrap.php的文件和main.php的主配置文件,因为这是我们新建的api应用,所以必须要设置api的别名。


在boostrap.php文件中添加:
Yii::setAlias('api', dirname(dirname(__DIR__)) . '/api');
当然我们也可以在common/config/boostrap.php中添加:
Yii::setAlias('api', dirname(dirname(__DIR__)) . '/api');
因为这个common/config/boostrap.php就是设置应用别名的,里面代码:
Yii::setAlias('@common', dirname(__DIR__));
Yii::setAlias('@frontend', dirname(dirname(__DIR__)) . '/frontend');
Yii::setAlias('@backend', dirname(dirname(__DIR__)) . '/backend');
Yii::setAlias('@console', dirname(dirname(__DIR__)) . '/console');
所以可以在这里添加设置api的别名,直接添加
Yii::setAlias('api', dirname(dirname(__DIR__)) . '/api');
那么还有一个main.php的主配置文件需要配置controllerNamespace属性

'controllerNamespace' => 'api\controllers',

'modules' => [
        'v1' => [
            'class' => 'api\modules\v1\Module'
        ]

],

其他的配置就按照web应用常规配置就可以了

(3)核心的控制器yii\rest\ActiveController

这个核心的控制器是设计restful的base类,我们创建的控制器必须继承这个yii\rest\ActiveController

通过指定 yii\rest\ActiveController::modelClass 作为 api\modules\v1\models\User, 控制器就能知道使用哪个模型去获取和处理数据。
当然这个api\modules\v1\models\User是可以直接继承\yii\db\ActiveRecord的

(4)配置路由组件

'urlManager' => [
    'enablePrettyUrl' => true,
    'enableStrictParsing' => true,
    'showScriptName' => false,
    'rules' => [
        [
        	'class' => 'yii\rest\UrlRule',
         	'controller' => ['v1/user']
        ],
    ],
]
随着以上所做的最小的努力,你已经完成了创建用于访问用户数据 的 RESTful 风格的 API。你所创建的 API 包括:

GET /users: 逐页列出所有用户
POST /users: 创建一个新用户
PUT /users/123: 更新用户123
DELETE /users/123: 删除用户123
PATCH /users/123 更新用户123
OPTIONS /users: 显示关于末端 /users 支持的动词
OPTIONS /users/123: 显示有关末端 /users/123 支持的动词
HEAD /users: 显示用户列表的概要信息
HEAD /users/123: 显示用户 123 的概述信息

大家可以在yiisoft/yii2/rest文件夹下面看到很rest组件的各个文件。

yii\rest\ActiveController的actions

public function actions()
    {
        return [
            'index' => [
                'class' => 'yii\rest\IndexAction',
                'modelClass' => $this->modelClass,
                'checkAccess' => [$this, 'checkAccess'],
            ],
            'view' => [
                'class' => 'yii\rest\ViewAction',
                'modelClass' => $this->modelClass,
                'checkAccess' => [$this, 'checkAccess'],
            ],
            'create' => [
                'class' => 'yii\rest\CreateAction',
                'modelClass' => $this->modelClass,
                'checkAccess' => [$this, 'checkAccess'],
                'scenario' => $this->createScenario,
            ],
            'update' => [
                'class' => 'yii\rest\UpdateAction',
                'modelClass' => $this->modelClass,
                'checkAccess' => [$this, 'checkAccess'],
                'scenario' => $this->updateScenario,
            ],
            'delete' => [
                'class' => 'yii\rest\DeleteAction',
                'modelClass' => $this->modelClass,
                'checkAccess' => [$this, 'checkAccess'],
            ],
            'options' => [
                'class' => 'yii\rest\OptionsAction',
            ],
        ];
    }
分别对应不同的独立的操作,这些独立的操作也对应这不同的访问urlrules。在yii/rest/UrlRule中

public $patterns = [
    'PUT,PATCH {id}' => 'update',
    'DELETE {id}' => 'delete',
    'GET,HEAD {id}' => 'view',
    'POST' => 'create',
    'GET,HEAD' => 'index',
    '{id}' => 'options',
    '' => 'options',
];
简单地说,当我们
a)以get方法访问http://localhost/lianxi/XML/advanced/api/web/v1/users,其实对应的独立操作就是yii/rest/IndexAction
b)以post方法访问http://localhost/lianxi/XML/advanced/api/web/v1/users,其实对应的独立操作就是yii/rest/CreateAction。
c)以get方法访问http://localhost/lianxi/XML/advanced/api/web/v1/users/1,就是获取id=1的用户,对应的独立操作yii/rest/ViewAction。
d)以put,patch方式访问http://localhost/lianxi/XML/advanced/api/web/v1/users/1,就是更改id=1的用户的信息,对应的独立操作yii/rest/UpdateAction。
这四个是常见的CURD操作。
那么我们可以如何测试这些接口呢?
利用google的开发工具postman可以很直观轻松的进行接口的测试。
get方式获取所有用户

yii2框架-restful的基础入门(二十一)_第1张图片


post方式创建新用户

yii2框架-restful的基础入门(二十一)_第2张图片

get方式获取id=1的用户

yii2框架-restful的基础入门(二十一)_第3张图片

put方式更新id=1的用户名为‘成龙’

yii2框架-restful的基础入门(二十一)_第4张图片

delete方式删除id=29的用户

yii2框架-restful的基础入门(二十一)_第5张图片






你可能感兴趣的:(yii2框架)