FuelPHP の Rest コントローラを使って Web API を作成したいと思います。
開発環境は以下の通りです。
特殊な環境ではないので、大きく環境差は出ないと思います。
アニメ作品の放送話リストを返すAPIを想定しています。
更新頻度の高くないデータだということをご留意ください。
単純な構成で、DBから取得した値をRESTコントローラでjson形式で返すようにします。
ちなみに DB から取得する値は以下の想定です。
| ID |
| タイトル |
| 放送日 |
| アニメオリジナル作品 |
それぞれ、以下の様な呼び出しにしようと思います。
http://localhost/api/anime/comicshttp://localhost/api/anime/original今回、データの挿入や更新を行うような管理画面の作成は行いません。
ドキュメントからの引用ですが、以下の様に使用します。
class Controller_Test extends Controller_Rest
{
public function get_list()
{
return $this->response(array(
'foo' => Input::get('foo'),
'baz' => array(
1, 50, 219
),
'empty' => null
));
}
}この場合、http://localhost/test/list.json?foo=barで呼び出すと、Input::get('foo')に"bar"という値が入り、以下の様な出力になります。
{
"foo": "bar",
"baz": [1, 50, 219],
"empty": null
}ちなみに以下のフォーマットが使用可能です。
以上の説明で解説すべき本筋が殆ど終わっていますが、実用的な形で実装例を紹介したいと思います。
以下の様な定数クラスを作成します。
/app/common/constant.php
class Constant {
const TIME_HOUR = 3600; // 1 hour
const TIME_DAY = 86400; // 24 hours
const TIME_WEEK = 604800; // 1 week
const ANIME_COMIC = 0;
const ANIME_ORIGIN = 1;
}以下に作成したクラスを追加します。
/app/bootstrap.php
Autoloader::add_classes(array(
'Constant' => APPPATH.'common/constant.php',
));Constant::TIME_DAYのような形で呼び出す事ができます。（他に良い方法があれば教えて下さい）
まず、データがないと始まりません。
今回の仕様はデータはすべてDBに格納してありますのでDBへアクセスをしてデータを取得します。
$result = DB::select()->from('users')->execute();データが取得出来さえすれば良いので、お好きなデータの管理・取得方法で問題はありません。
呼び出される度にDB通信を行っていては時間がかかるかと思います。その場合、クエリキャッシュを利用します。
$result = DB::select()->from('users')->cached(3600)->execute();上記の使用例だと 3600 秒キャッシュが有効になります。cached()の詳しいフォーマットに関してはドキュメントを参照ください。
指定する秒数は定数にしておくと良いです。
継承用のコントローラを作成します。
今回は anime に関する API を作成しますが、今後 music や movie など新しい API を作成した際、同じ仕様であれば同じようなコーディングをするかと思います。それをバラバラに記述すると保守が非常に面倒になります。予め共通の処理を実装したベースのコントローラを作成しておくことで、 API 用のコントローラはそれを継承するだけで無駄なコーディングをする必要がなくなります。
ベースになるコントローラを以下に配置します。
/app/classes/controller/base/rest.php
class Controller_Base_Rest extends Controller_Rest {
protected $format = "json";
}今回は特に共通処理を考えていないので、$formatだけ指定した例になります。
共通で json 形式のデータを返したいので上記のような指定を入れています。
この場合、継承は以下の様な指定になります。
class Controller_Api_Anime extends Controller_Base_Rest {
//
}コントローラにはデータ取得関数だけ記述したいので、処理はModelなどに記述します。
public function get_original() {
return Model_Api::get_data(Constant::ANIME_ORIGIN_NAME, Constant::ANIME_ORIGIN_TYPE);
}クエリキャッシュと重複しますが、動的に変更がない場合はCacheクラスを使うと良いでしょう。
詳しいインタフェースなどは割愛しますが、使用例は以下です。
public static function get_data($data_name = null, $data_type = 0) {
$data = null;
try {
// キャッシュからデータを取得する
$data = Cache::get($data_name);
} catch (CacheNotFoundException $e) {
// キャッシュがない場合
// DBからデータを取得する
$data = Model_Api::get_anime($data_type);
if ($data && $data_name) {
// 改めてキャッシュにデータをセットする
Cache::set($data_name, $data, Constant::TIME_WEEK);
}
}
return $data;
}処理の流れとしては以下です。
CacheNotFoundExceptionが発生簡単に説明すると、「キャッシュがある場合はキャッシュからデータを取得」「キャッシュがない場合はDBから取得」というような感じです。
指定した時間キャッシュが残りますので、データ変更時や任意のタイミングでキャッシュが出来るような処理も作成した方が良いです。
割愛している箇所もありますが、概ね以下の様な感じです。
class Controller_Api_Anime extends Controller_Base_Rest {
public function get_comics() {
return Model_Api::get_data(Constant::ANIME_COMIC_NAME, Constant::ANIME_COMIC_TYPE);
}
public function get_original() {
return Model_Api::get_data(Constant::ANIME_ORIGIN_NAME, Constant::ANIME_ORIGIN_TYPE);
}
}それぞれが以下に対応しています。
get_comics() | http://localhost/api/anime/comics |
get_original() | http://localhost/api/anime/original |
get_anime()はget_data()からしか呼ばないのでprivateにしてます。
class Model_Api extends Model {
public static function get_data($data_name = null, $data_type = 0) {
$data = null;
try {
// キャッシュからデータを取得する
$data = Cache::get($data_name);
} catch (CacheNotFoundException $e) {
// キャッシュがない場合
// DBからデータを取得する
$data = self::get_anime($data_type);
if ($data && $data_name) {
// 改めてキャッシュにデータをセットする
Cache::set($data_name, $data, Constant::TIME_WEEK);
}
}
return $data;
}
private static function get_anime($original = null) {
$query = DB::select("hoge1", "hoge2", "hoge3")->from('table');
if (!is_null($original)) {
$query = $query->where('hoge4', $original);
}
return $query->cached(Constant::TIME_WEEK)->execute()->as_array();
}
}無駄な処理も少々ありますが、概ねこんな実装で良いのではないでしょうか。