Yii2 使用 RESTful 写API接口 实例

原创 2016年02月01日 13:30:23

Yii2 使用 RESTful?

其实 Yii2 框架本身就对 RESTful 是友好支持的,具体可以看官方文档(http://www.yiichina.com/doc/guide/2.0/rest-quick-start),或者去看源码,都是可以的

注意: 我们使用resTful的同时,需要借助于测试工具进行地址访问,例如: 谷歌的PostMAN,火狐的HttpRequester工具来访问

创建一个控制器 

我的工作目录如图所示 (首先, 参照下面的目录图片,可以看出,我创建了两个大的文件夹,v1,v2,目的是测试访问不同版本的接口)


下面以v2中的文件为例:

创建一个控制器类 api\modules\v2\UserController 如下,

namespace api\modules\v2\controllers;

use yii\rest\ActiveController;

class UserController extends ActiveController
{
    public $modelClass = 'api\modules\v2\models\user\UserBaseInfo';
}

控制器类扩展自 yii\rest\ActiveController。通过指定 yii\rest\ActiveController::modelClass作为api\modules\v2\models\user\UserBaseInfo, 控制器就能知道使用哪个模型去获取和处理数据。

配置URL规则

修改有关在应用程序配置的urlManager组件的配置:

'urlManager' => [
    'enablePrettyUrl' => true,
    'enableStrictParsing' => true,
    'showScriptName' => false,
    'rules' => [
        ['class' => 'yii\rest\UrlRule', 'controller' => 'user'],  
    ],
]

说明: 

      a): 上面的配置主要是为user控制器增加一个 URL 规则。这样,用户的数据就能通过美化的 URL 和有意义的 http 动词进行访问和操作。

      b): 上面是没有加上版本的url配置,至于关于版本我将以新的一篇来说明.


配置另外的:

'controllerNamespace' => 'api\controllers',
'components' => [
        'user' => [
            'identityClass' => 'api\modules\v1\models\oauth\AccessToken',
            'enableAutoLogin' => true,
            'enableSession' => false,
            'loginUrl' => null
        ],

尝试

随着以上所做的最小的努力,你已经完成了创建用于访问用户数据的 RESTful 风格的 API。你所创建的 API 包括:

相比于URL管理的Web应用程序,上述主要的新东西是通过RESTful API请求yii\rest\UrlRule。这个特殊的URL规则类将会建立一整套子URL规则来支持路由和URL创建的指定的控制器。例如, 上面的代码中是大致按照下面的规则:

[
    'PUT,PATCH users/<id>' => 'user/update',
    'DELETE users/<id>' => 'user/delete',
    'GET,HEAD users/<id>' => 'user/view',
    'POST users' => 'user/create',
    'GET,HEAD users' => 'user/index',
    'users/<id>' => 'user/options',
    'users' => 'user/options',
]

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

补充:Yii 将在末端使用的控制器的名称自动变为复数。(译注:个人感觉这里应该变为注意)


经过上面的配置后,你会看到你的控制类继承的是yii\rest\ActiveController,如果你进这个文件后,你会看到下面这些方法:

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',
            ],
        ];
    }

    /**
     * @inheritdoc
     */
    protected function verbs()
    {
        return [
            'index' => ['GET', 'HEAD'],     
            'view' => ['GET', 'HEAD'],      
            'create' => ['POST'],
            'update' => ['PUT', 'PATCH'],
            'delete' => ['DELETE'],
        ];
    }

从上面的方法我们可以知道,如果在你使用yii框架自带的方法时,它默认有create, delete, update, index, view等的一下方法

所创建的 API 包括:

  • GET /users: 逐页列出所有用户
  • POST /users: 创建一个新用户
  • GET /users/123: 返回用户 123 的详细信息
  • PATCH /users/123 and PUT /users/123: 更新用户123
  • DELETE /users/123: 删除用户123
但是如果你要是不想用他的某些方法,我们可以通过下面的方法来自己覆盖对应的方法

例如:

public function actions()
{
    $actions = parent::actions();

    // 注销系统自带的实现方法
    unset($actions['index']);
    
    //unset($actions['create']);
    //unset($actions['update']);
    //unset($actions['delete']);

  return $actions;
}

//覆盖父类的actionIndex方法,并进行重写
public function actionIndex()
{
    //获取用户所有信息
    ......
}

对于其他的方法同上....

于是我们就可以通过方法地址获取想要的数据:GET  http://www.api.com/users


相关文章推荐

Yii2 基于RESTful架构的 advanced版API接口开发 配置、实现、测试

环境配置: 开启服务器伪静态 本处以apache为例,查看apache的conf目录下httpd.conf,找到下面的代码 LoadModule rewrite_module modules/m...
  • lmjy102
  • lmjy102
  • 2017年01月16日 21:20
  • 1241

Yii2.0 探究五:基于Yii2.0框架的Restful Api的对接以及跨域解决

基于Yii2.0框架的Restful Api的对接以及跨域解决; 在yii2.0框架中集成了restful api的部分,封装在yii\rest下,我们要做的工作有: 1.apache或ngi...

yii2 RESTful api的详细使用

原文地址: http://www.manks.top/yii2-restful-api.html 什么是RESTful风格的API 对于各种客户端设备与服务端的通信,我们往往都...
  • lmjy102
  • lmjy102
  • 2017年02月16日 15:50
  • 765

yii2 RESTful access_token api 初步搭建2

为了自我学习和交流PHP(jQuery,Linux,lamp,shell,JavaScript,服务器)等一系列的知识,希望光临本博客的人可以进来交流。寻求共同发展。搭建平台。本人博客也有许多的技术文...

yii2项目实战-restful api之授权验证

什么是restful风格的api呢?我们之前有写过大篇的文章来介绍其概念以及基本操作。 既然写过了,那今天是要说点什么吗? 这篇文章主要针对实际场景中api的部署来写。 我们今天就来...

yii2 api restful 验证 速度控制

1. 创建数据库表: sql创建: -- phpMyAdmin SQL Dump -- version 3.3.10 -- http://www.phpmyadmin.net -- -- 主机: lo...

yii2 RESTful 接口 api -6: 写一个自己的api

1. 创建api的 应用分区,类似backend   frontend   这样可以用一个单独的域名,以及单独的配置 可以复制frontend过来,然后改改 然后在\common\config\boo...

RESTful介绍和yii2中RESTful如何配置

RESTful介绍和yii2中RESTful如何配置   REST的名称"表现层状态转化"中,省略了主语。"表现层"其实指的是"资源"(Resources)的"表现层"。 从学术上来讲:    ...
  • aozeahj
  • aozeahj
  • 2016年09月02日 22:21
  • 3283

yii2框架-restful的自定义api(二十二)

昨天的大新闻---国家的相关监管部门正式出台了“网约车”的合法法规!滴滴,UBER,易到,神州专车等积极响应,表示支持网约车的新规!一方面看来是这些企业受益,其实从侧面映射中国的移动互联网中的o2o服...

Restful API 简单示例--HelloWorld

Restful API 简单示例--HelloWorld 1. 环境 (1). j2ee luna (2). Tomcat7 (3). Jersey2.24 (jaxrs-ri-2.24.zip) ...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Yii2 使用 RESTful 写API接口 实例
举报原因:
原因补充:

(最多只允许输入30个字)