laravel 5.5 快速配置 Dingo Api

laravel version: 5.5.*

爲何不用 laravel 自帶的 response ? 原生的 response 可能不夠強大,可能不夠方便,也可能我的喜愛問題,總之, 我仍是比較喜歡 dingo api

資料參考

github
documention
中文社區

建立一個 laravel 項目

composer create-project laravel/laravel=5.5.*  --prefer-dist  ./dingo

安裝dingo擴展

composer require dingo/api

添加服務提供者

php artisan vendor:publish

修改env

詳細解釋請看這裏

API_STANDARDS_TREE=vnd
API_SUBTYPE=study
API_PREFIX=
API_DOMAIN=api.study.io
API_VERSION=v1
API_NAME=study
API_CONDITIONAL_REQUEST=false
API_STRICT=false
API_DEFAULT_FORMAT=json

建立 api 路由

示例

$api = app('Dingo\Api\Routing\Router');
$api->version('v1', ['middleware' => 'enableCrossRequests'], function ($api) {
    $api->group(['namespace' => '\App\Http\Controllers\Api'], function ($api) {
        /**
         * 註冊
         */
        $api->post('/register', 'UsersController@register');
        /**
         *  登錄
         */
        $api->post('/login', 'UsersController@captcha');
    });
});

---

這條線如下的是可選操做,純屬我的喜愛

建立一個基礎類讓其餘類繼承

namespace App\Http\Controllers\Api;

use Dingo\Api\Routing\Helpers;

class BaseController extends Controller
{
    use Helpers;

    /**
     * 快速響應一個json格式的字符串
     * @param string $message        詳細信息
     * @param array  $data           響應的數據
     * @param int    $responseCode   響應狀態碼
     * @return mixed
     */
    public function jsonResponse(string $message = '', array  $data = [], int $responseCode = 200)
    {
        return $this->response->array([
            'message' => $message,
            'data' => $data
        ])->setStatusCode($responseCode);
    }
}