chatbox-inc/lumen-restapi

Lumen Application

, _(*1)

Rest API アプリケーション作成用のミドルウェア, _(*2)

レスポンス生成の一元化とエラーハンドリングを担う。, _(*3)

機能

• RestAPI Response整形の1極化
• ExceptionHandlerの搭載

Usage

Exception Handler はデフォルトのものを使用する想定, _(*4)

$app->singleton(\Illuminate\Contracts\Debug\ExceptionHandler::class,\App\Exceptions\Handler::class);

対象のルートにミドルウェアを二枚かける, _(*5)

ミドルウェアの設定順序には注意すること。, _(*6)

$app->group([
    "middleware" => [
        \Chatbox\RestAPI\Http\Middleware\HttpExceptionHandler::class,
        \Chatbox\RestAPI\Http\Middleware\APIResponseHandler::class
        ]
],function($router){
    $router->get("/api/status",function(){
        return [];
    });

    $router->get("/api/missing",function(){
        abort(404);
    });

    $router->get("/api/error",function(){
        throw new \Exception();
    });
});

拡張

全ての例外は一度 HttpRequest で投げられるので、そこから処理してあげると楽だったり。, _(*7)

400 系エラー例外はHttpExcepiton 継承で投げると特別処理がかかる。, _(*8)

Responseを操作する時

\Chatbox\RestAPI\Http\Response を拡張する。, _(*9)

Exceptionsを操作する時

\Chatbox\RestAPI\Exceptions\Handler を拡張する。, _(*10)