APIをGETでコールして配列を取得したい
ちょっとしたプロジェクトで、他社サービスのAPIを利用する必要があったのでメモ。PHPからAPIをGETでコールして戻ってくるJSONデータ(文字列)をPHP用に配列にパースして戻す処理を書きたかったので書いた。
/**
* GET Request send.
*
* @param string $url
* @param array $params
* @return array|boolean $data
*/
public function getJson( $url, $params = [] ) {
if ( count( $params ) > 0 ) {
$query = '?' . http_build_query( $params );
} else {
$query = '';
}
$url .= $query;
$response = get_headers( $url );
if ( preg_match( '/(200)/', $response[0] ) ) {
$headers = array(
'Content-type: application/json; charset=UTF-8',
'Accept: application/json'
);
$options = [ 'http' => [
'method' => 'GET',
'header' => implode( '\r\n', $headers )
]];
$data = file_get_contents( $url, false, stream_context_create( $options ) );
if ( $data !== false ) {
$data = json_decode( $data );
}
} else {
$data = false;
};
return $data;
}
処理の流れは以下の通り。
- 9 – 13行目:引数の$paramsがセットされてくれば
http_build_query
関数でクエリ文字列を生成 - 14行目:クエリ文字列をURLに結合
- 16行目:
get_headers
関数でAPI先のヘッダー情報を取得 - 18行目:ヘッダー情報からレスポンスコード200(正常)を判断
- 19 – 22行目:セットするヘッダー情報を配列に保存
- 24 – 27行目:ストリームコンテキスト用のオプション情報を配列に保存
- 29行目:
file_get_contents
関数でコンテンツを取得 - 31 – 33行目:正常に取得できたら
json_decode
関数でJSON文字列形式を配列に変換
この関数をClass化して(getRequestという名前にします)、インスタンスを生成して動かしてみます。試しに、このサイトのWP REST APIを使用して、カテゴリー番号「1」のデータを1件コールしてみます。
$response = new getRequest();
$params = [
"per_page" => 1,
"categories" => 1
];
$response->getJson( "https://www.terakoya.work/wp-json/wp/v2/posts", $params );
とれた!\(^o^)/
これでAPIに接続してデータの取得をしよう。
重いぞ……file_get_contents
先程1件取得する処理は対して時間がかからなかったのですが、10件取ろうと思ったら重い……6秒ぐらいかかる。そこで、cURL(カール)を使用して同じ処理を書いてみました。
/**
* GET Request send.(cURL)
*
* @param string $url
* @param array $params
* @return array|boolean $data
*/
public function curlJson( $url, $params = [] ) {
if ( count( $params ) > 0 ) {
$query = '?' . http_build_query( $params );
} else {
$query = '';
}
$url .= $query;
$headers = [
'Content-type: application/json; charset=UTF-8',
'Accept: application/json'
];
if ( !function_exists( 'curl_version' ) ) {
return false;
}
$ch = curl_init();
curl_setopt( $ch, CURLOPT_URL, $url );
curl_setopt( $ch, CURLOPT_TIMEOUT, 60 );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
curl_setopt( $ch, CURLOPT_HTTPHEADER, $headers );
$data = curl_exec( $ch );
$response = curl_getinfo( $ch, CURLINFO_HTTP_CODE );
curl_close( $ch );
if ( $response === 200 ) {
$data = json_decode( $data );
} else {
$data = false;
};
return $data;
}
処理の流れは以下の通り。
- 9 – 13行目:引数の$paramsがセットされてくれば
http_build_query
関数でクエリ文字列を生成 - 14行目:クエリ文字列をURLに結合
- 16 – 19行目:セットするヘッダー情報を配列に保存
ここまではfile_get_contentsでの処理と同じ。ここからcURL(カール)の出番。
- 21 – 23行目:
curl_version
関数の存在チェックをしてcURLがインストールされているか確認 - 25行目:
curl-init
関数でcURLのセッションを初期化 - 27 – 30行目:
curl_setopt
関数でcURL転送用オプションを設定 - 31行目:
curl_exec
関数でセッションを実行 - 33行目:
curl_getinfo
関数に引数でCURLINFO_HTTP_CODEを渡しレスポンスコードを取得 - 35行目:
curl_close
関数でcURLのセッションを閉じる - 37 – 41行目:レスポンスコード200(正常)が返ってきたら
json_decode
関数でJSON文字列形式を配列に変換
これを同じようにクラス内に定義してコールしてみます。
$response = new getRequest();
$params = [
"per_page" => 1,
"categories" => 1
];
$response->curlJson( "https://www.terakoya.work/wp-json/wp/v2/posts", $params );
取れた!\(^o^)/(速い!)
うおお、6秒が1秒になった速い。しかし、file_get_contentsを使うにしても、cURLを使うにしてもその環境で使えるかどうかの判断処理は入れる必要があるな。