keal/laravel-output

Laravel standard output for restful api

关于Laravel项目规范Api输出和错误提示（测试版本）

安装

建议使用Laravel >= 5.1.* , PHP >= 5.6, _(*1)

composer require keal/laravel-output, _(*2)

使用

注册ServiceProvider

在app.php中加入Caikeal\Output\Provider\OutputServiceProvider::class, _(*3)

引入错误处理

需要在Exceptions/Handler.php中引入Caikeal\Output\Exceptions\HandlerTrait该方法， 然后在改写下render方法，如下：, _(*4)

    public function render($request, Exception $exception)
    {
        if ($request->expectsJson()) {
            return $this->handlerApi($exception);
        }

        return parent::render($request, $exception);
    }

引入返回值基类

在所有Controller的基类中引入该方法，如下：, _(*5)

    protected function response()
    {
        return app('output.response');
    }

返回方法

在返回时可以用该方法代替response返回：$this->reponse()的方法 所有方法如下： + 正确值返回： - model层，且带有transformer验证的单列数据：$this->response()->item([Model], [Transformer]); - model层，且带有transformer验证的多列数据：$this->response()->collection([Model], [Transformer]); - model层，且带有transformer验证的分页数据：$this->response()->paginator([Model], [Transformer]); - 任意：$this->response()->array([Model/Array]);, _(*6)

返回值样式：
```
  {
    "data": {
      "name": "keal"
    },
    "meta": {
      "type": "seller"
    }
  }
```

• 错误值返回：, _(*7)

  • 404错误：$this->response()->errorNotFound([$message], [$code])
  • 400错误：$this->response()->errorBadRequest([$message], [$code])
  • 403错误：$this->response()->errorForbidden([$message], [$code])
  • 500错误：$this->response()->errorInternal([$message], [$code])
  • 401错误：$this->response()->errorUnauthorized([$message], [$code])
  • 405错误：$this->response()->errorMethodNotAllowed([$message], [$code])
  • 任意错误：$this->response()->error([$message], [$statusCode], [$code])

  返回值样式：, _(*8)

    {
      "code": "401000",
      "status_code": "401",
      "message": "Wrong."
    }
  

Transformer的数据格式转换

在所有Transformer类中必须继承League\Fractal\TransformerAbstract，使用如下：, _(*9)

    namespace App\Transformers;

    use App\User;
    use League\Fractal\TransformerAbstract;

    class UserTransformer extends TransformerAbstract
    {
        public function transform(User $data){
            return [
                'id'=>intval($data['id']),
                'name'=>ucfirst($data['name'])
            ];
        }
    }

Artsian创建Transformer类

创建Transformer：php artisan make:transformer User, _(*10)

附带Model名：php artisan make:transformer User -m User, _(*11)

或者php artisan make:transformer User --model=User, _(*12)

或者php artisan make:transformer User --model=Model/User 带位置，命令会自动转化成空间名，并在开头添加App, _(*13)

感谢

主要借鉴和引用了Dingo/api和league/fractal, _(*14)