leegoway/yii2-rest

The Yii2 Rest extension for the Yii framework

The Yii2 Rest extension for the Yii framework

The Yii2 Rest extension for the Yii framework, _(*1)

Installation

The preferred way to install this extension is through composer., _(*2)

Either run, _(*3)

php composer.phar require --prefer-dist leegoway/yii2-rest "*"

or add, _(*4)

"leegoway/yii2-rest": "*"

to the require section of your composer.json file., _(*5)

Usage

格式化的ActiveController输出

Once the extension is installed, simply use it in your controller as base controller by :, _(*6)

then you can get formatted output like : {"code":200, "msg":"", "data":{...}}, _(*7)

主动使用格式化类进行格式化输出

Besides, use the formatter class anywhere you need like this :, _(*8)

use leegoway\rest\Formatter;

...
Formatter::success($data);//返回业务数据
Formatter::error($errors);//返回校验失败的数据
Formatter::fail($msg);//业务逻辑问题导致的失败

then you can get formatted output., _(*9)

捕获业务异常

Last，you can use following method to catch your defined exception and output formatted response., _(*10)

a、modify your config file

'errorHandler' => [
    'class' => 'leegoway\rest\RestErrorHandler',
    'errorAction' => 'site/error',
    'restErrorAction' => 'error/error'
],

b、modify your error/error controller

<?php
namespace app\controllers;

class MyController extends leegoway\rest\RestErrorController
{
}

c、throw exception which based on leegoway\rest\RestException

throw new leegoway\rest\RestException('msg', code);

对actions进行权限控制

Third, if you need check permission of action level, you cound write code like following:, _(*11)

a、and you should reuqire leegoway\yii2-uic

composer require leegoway\yii2-uic

b、modify your config

return [
    'components' => [
        'uicAuther' => [
            'class' => 'leegoway\uic\Auther',
            'domain' => 'autops.corp.elong.com',//cookie的domain属性
            'path' => '/',//cookie的路径
            'expire' => 7200 //超时时间
        ]
    ],
];

c、check your action permission

class MyController extends RestActiveController
{
    public $uicRules = [
        'index' => [
            'orgainzationId' => '...',
            'permissionId' => '...'
        ],
        'view' =>  [
            'orgainzationId' => '...',
            'permissionId' => '...'
        ],
        ...
    ];

}