【fuelphp】RestApiをつくったときのまとめ

はじめに

フロントエンドのアプリ開発がメインの案件ではあったのですが、結局サーバ側もけっこういじりました。

自分がメインの案件ではなかったのですが
そこそこの期間をかけてAPIを実装して今までにない経験もしたのでそろそろメモしておきます。

自分流とは1番違う点としてはfuelphpのクエリビルダーを駆使したことでしょうか

設定系

rest api設定

本番環境ではSSLでの実装になるので、いらないっちゃいらないのですが気休め程度にBasic認証をいれました

fuel/app/config/***/rest.php

return array(
    'auth' => 'basic',
    'valid_logins' => array('hoge' => 'hogepass'),
);
db設定

dbは基本的なmysqlのマスター・スレーブ構成になります。

fuel/app/config/***/db.php

return array(
    'rw'    => array(
        'type'  => 'pdo',
        'connection' => array(
            'dsn' => 'mysql:host=localhost;dbname=hoge'
            'username' => 'hoge_rw',
            'password' => 'hoge',
            'persistent'    => false,
            'compress'      => false,
        ),
        'identifier'    => '`',
        'table_prefix'  => '',
        'charset'       => 'utf8',
        'enable_cache'  => true,
        'profiling'     => true,
        'readonly'      => false,
    ),

    'ro'    => array(
        'type'  => 'pdo',
        'connection' => array(
            'dsn' => 'mysql:host=localhost;dbname=hoge
            'username'      => 'hoge_ro',
            'password'      => 'hoge',
            'persistent'    => false,
            'compress'      => false,
        ),
        'identifier'    => '`',
        'table_prefix'  => '',
        'charset'       => 'utf8',
        'enable_cache'  => true,
        'profiling'     => true,
        'readonly'      => false,
    ),
);
SQLクエリログ

初めて使ったクエリビルダーです。
便利と感じることも手間とかんじることも両方ありましたが勉強になりました。
で、特に開発中はログを確認しながらというのはよくあることなのだと思うのでこれも必須でしょうか

上記でもそうしましたが、db.phpのprofiling = trueにすること必要になります
ついでに重そうなクエリも早めに気づくように簡単に重そうなクエリのログ出力もいれてみました(これは、あまり見てませんが、、、)

fuel/app/config/***/event.php

return array(
    'fuelphp' => array(
        'shutdown' => function() {
            $ref = new ReflectionClass('Profiler');
            $prop = $ref->getProperty('profiler');
            $prop->setAccessible(true);
            $profiler = $prop->getValue();
            if ($profiler) {
                $profiler->db = $profiler;
                $profiler->gatherQueryData();
                foreach ($profiler->output["queries"] as $v) {
                    $is_slow = "";
                    if (preg_match('/([0-9]{1,}\.[0-9]{1,}) ms/', $v["time"], $matches)) {
                        if ("100" < $matches[1]) {
                            $is_slow = "SQL IS SLOW";
                        }
                    } else if (preg_match('/([0-9]{1,}\.[0-9]{1,}) s/', $v["time"], $matches)) {
                        $is_slow = "SQL IS SLOW";
                    }
                    \Log::info(sprintf("[SQLデバッグ]%s\t%s\t%s", htmlspecialchars_decode($v["sql"], ENT_QUOTES), $v["time"], $is_slow));
                }
            }
        },
    ),
);

このevent.phpに記述する方法はQuitaのどこかの記事を参考にさせていただいたので、どの記事かみつけたら紹介します

ベースコントローラ

baseコントローラの作成

ありがちなベースコントローラ

<?php
class ValidateException extends Exception {} // バリデーションエラー        
class SystemErrorException extends Exception {} // PHPエラーなど            

class Controller_Base extends Controller_Rest
{
   protected $format = 'json';

   public function before()
   {
       $this->start_time = microtime(true);

       parent::before();

       try
       {
           //アクセスログ出力                                                        
           Log::info(sprintf(
               "ACCESS\t%s\t%s\t%s\t%s\t%s\t%s"
               ,Input::server("REMOTE_ADDR")
               ,Input::server("HTTP_USER_AGENT")
               ,urldecode(Input::server("REQUEST_URI"))
               ,Input::server("HTTP_REFERER")
               ,json_encode(Input::get())
               ,json_encode(Input::post())
           ));

           Log::info(sprintf(
               "DEBUG:%s\t%s", Request::main()->controller, Request::active()->action
           ));
       }
    }

    // 正常時のレスポンスをかえすメソッド
    protected function success($results = null)
    {
        $response = array(
            'status' => 'OK',
            'results' => $results,
        );
        return $this->response($response);
    }

    // 異常時のレスポンスをかえすメソッド
    protected function error($message = null)
    {
        $response = array(
           'status' => 'NG',
           'message' => $message,
        );
        return $this->response($response);
    }

    // システムエラー時のレスポンスをかえすメソッド
    protected function system_error($ex)
    {
        Log::info("システムエラー::" . $ex->getMessage());
        Config::load("const", true);
        $title = "[システム名]システムエラー";
        $body  = "▪️システムエラー内容" . "\n";
        $body .= $ex->getMessage() . "\n\n";
        $body .= "▪️コントローラ/アクション\n";
        $body .= Request::main()->controller . "/" . Request::active()->action . "\n\n";
        $body .= "▪️詳細" . "\n";
        $body .= print_r($ex, true);
        $email = Email::forge();
        $email->from(Config::get("const.email.system_from"), Config::get("const.email.system_from"));
        $email->to(Config::get("const.email.alert_to"));
        $email->subject($title);
        $email->body($body);
        $email->send();
        $this->error();
    }

    // dbエラー時のレスポンスをかえすメソッド
    protected function db_error($ex)
    {
        Log::info("DBエラー::" . $ex->getMessage());
        Config::load("const", true);
        $title = "[システム名]DBエラー";
        $body  = "▪️SQL" . "\n";
        $body .= $ex->getMessage() . "\n\n";
        $body .= "▪️コントローラ/アクション\n";
        $body .= Request::main()->controller . "/" . Request::active()->action . "\n\n";
        $body .= "▪️詳細" . "\n";
        $body .= print_r($ex, true);
        $email = Email::forge();
        $email->from(Config::get("const.email.system_from"), Config::get("const.email.system_from"));
        $email->to(Config::get("const.email.alert_to"));
        $email->subject($title);
        $email->body($body);
        $email->send();
        $this->error();
    }

各コントローラのフォーマット

基本的にDBエラーとシステムエラー(致命的なエラー)は確実に検出できるようにかならずtry〜catchでくくるようにしました

class Controller_Hoge extends Controller_Base
{
    public function action_sample()
    {
        try
        {
            // 必須のパラメータチェックなど
            if (!Input::post("parameter"))
            {
                throw new ValidateException;
             }
    }
    catch(ValidateException $ex)
    {
        return $this->error(trim($ex->getMessage()));
    }
    // DBエラー
    catch(Database_Exception $ex)
    {
        $this->db_error($ex);
    }
    // システムエラー
    catch(System_Exception $ex)
    {
        $this->system_error($ex);
    }
}

こんなものでしょうか。
後日、追加するかもしれませんが

以上です