1. 必要なもの
2. 短縮してみよう
3. 展開してみよう
4. めんどくさいのでクラスにしてみる
5. (おまけ) JavaScriptで展開する

必要なもの

APIのURLを控えておく

https://www.googleapis.com/urlshortener/v1/url

APIキーを取得しておく

Google APIs Consoleで
「URL Shortener API」をアクティブにしてAPIキーを控えて来る

今回は、PHP+cURLでやってみることに。
とりあえず持っている情報を変数につっこむ。

$api_url = "https://www.googleapis.com/urlshortener/v1/url";
$api_key = "[あなたのAPIキーを入れてください]";

短縮してみよう

URLの短縮は、APIに次のようなJSONをPOSTで送りつけます。

{“longUrl”: “http://www.google.com/”}

$longUrl = "https://blog.mach3.jp/";

$curl = curl_init();
$curl_params = array(
    // APIのURLに ?key=[your-key]を足してやります
    CURLOPT_URL => $api_url . "?" .
        http_build_query( array( "key" => $api_key ) ),
    // ヘッダをapplication/jsonに
    CURLOPT_HTTPHEADER => array( "Content-Type: application/json" ),
    // POSTで送ります
    CURLOPT_POST => true,
    // ロングURLの情報をJSONに加工して渡します
    CURLOPT_POSTFIELDS => json_encode( array( "longUrl" => $longUrl ) ),
    CURLOPT_RETURNTRANSFER => true
);
curl_setopt_array( $curl, $curl_params );
$result = json_decode( curl_exec( $curl ) ); // 返り値はJSONなのでデコード
var_dump( $result );

レスポンスはJSONで返って来るので、json_decodeでオブジェクトにしてやります。
最終的に格納されている情報はこんな感じ。

object(stdClass)#1 (3) {
  ["kind"]=>
  string(16) "urlshortener#url"
  ["id"]=>
  string(19) "http://goo.gl/ZZKde"
  ["longUrl"]=>
  string(21) "https://blog.mach3.jp/"
}

展開してみよう

展開は簡単。パラメータくっつけてGETでとってくるだけです。
先ほど作った「http://goo.gl/ZZKde」を展開してみます。
こんなリクエストをおくって返事をもらってるだけ。
労力惜しむならfile_get_contents()でもよし。

https://www.googleapis.com/urlshortener/v1/url?key=[your_api_key]&shortUrl=[展開したいURL]

$shortUrl = "http://goo.gl/ZZKde";

$curl = curl_init();
$curl_params = array(
    CURLOPT_URL => $api_url . "?" .
        http_build_query( array(
            "key" => $api_key,
            "shortUrl" => $shortUrl
        )),
    CURLOPT_RETURNTRANSFER => true
);
curl_setopt_array( $curl, $curl_params );
$result = json_decode( curl_exec( $curl ) );

こんな感じに帰ってきました。

object(stdClass)#2 (4) {
  ["kind"]=>
  string(16) "urlshortener#url"
  ["id"]=>
  string(19) "http://goo.gl/ZZKde"
  ["longUrl"]=>
  string(21) "https://blog.mach3.jp/"
  ["status"]=>
  string(2) "OK"
}

めんどくさいのでクラスにしてみた

GoogleUrl

gist: 69e4a0c19e4776924a21 – Shorten and expand urls using Google URL Shortener API- GitHub

使い方

// createメソッドで初期化。
// new GoogleUrl( $api_key ) でもいいです。
$gu = GoogleUrl::create( "[your-api-key]" );

try {
    // shortenメソッドで短縮
    $shorten = $gu->shorten( "http://www.mach3.jp" );
    var_dump( $shorten );

    // expandメソッドで展開
    $expand = $gu->expand( $shorten->id );
    var_dump( $expand );

} catch( Exception $e ){ die( $e->getMessage() ); }

(おまけ) JavaScriptで展開する

gist: d98215a9cae6ef22e741 – expand url using goo.gl shortener api- GitHub

jQuery使って展開してみました。
「callback」パラメータでJSONP出来るので、大変簡単。
つまりこんなリクエストをすることになります。

https://www.googleapis.com/urlshortener/v1/url?key=[your_api_key]&shortUrl=[展開するURL]&callbck=[コールバック関数名]

var expandGoogleUrl = function( url, key, callback ){
    $.ajax({
        url : "https://www.googleapis.com/urlshortener/v1/url",
        dataType : "jsonp",
        data : { shortUrl : url, key : key },
        success : function( data ){
            callback( data.error  ? false : data.longUrl );
        }
    });
};

// example
expandGoogleUrl (
    "http://goo.gl/fbsS",
    "[your api key]",
    function( url ){
        console.log( url );
    }
);

QRコードがそのまま作れたり（ http://goo.gl/pvqxy.qr ）、
アクセス解析出来たり（ http://goo.gl/info/pvqxy ）と結構便利なサービスです。
短縮したい際には使ってみようかな！

パフォーマンスの差

具体的にどれくらいパフォーマンスが変わるのかというと…
モバイル回線のノートでYahoo!のトップページを取得してざっくり計測したところ、

• file_get_contents : 4秒前後
• cURL : 2秒前後

概ねこんな感じとなりました。
勿論時間帯や回線など様々な要因にもよりますが、
ちょっと無視出来ない数字ですね。

cURLを使う

簡単な使い方

cf) PHP: cURL – Manual

1. curl_init()で初期化
2. curl_setopt()でオプションを設定して
3. curl_exec()で実行
4. curl_close()で終了

というのが一連の流れです。
curl_setoptで渡すオプションにより、cURLさんにどんな動作をさせるのかを設定します。

$url = "http://www.example.com";
$ch = curl_init(); // 1. 初期化
curl_setopt( $ch, CURLOPT_URL, $url ); // 2. オプションを設定
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
$result = curl_exec( $ch ); // 3. 実行してデータを得る
curl_close(); // 4. 終了

オプションについて

オプション一覧
cf) PHP: curl_setopt – Manual

今回使うものだけ軽くメモ。

CURLOPT_URL

アクセスするurlです。これがないと始まりません。

CURLOPT_HEADER

ヘッダ文字列を一緒に出力するかどうかのBoolean値。
邪魔なのでfalseにします。

CURLOPT_RETURNTRANSFER

curl_execの返り値を文字列にする為のBoolean値。
これをtrueにしてやらないと、データが直接出力されます。

CURLOPT_TIMEOUT

cURLさんに頑張ってもらう秒数です。
これを超えると諦めてfalseを返します。

関数にまとめてみる

簡単に使えるように関数にまとめてみます。

function curl_get_contents( $url, $timeout = 60 ){
    $ch = curl_init();
    curl_setopt( $ch, CURLOPT_URL, $url );
    curl_setopt( $ch, CURLOPT_HEADER, false );
    curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
    curl_setopt( $ch, CURLOPT_TIMEOUT, $timeout );
    $result = curl_exec( $ch );
    curl_close( $ch );
    return $result;
}

// test
$result = curl_get_contents( "http://www.example.com", 120 );

第二引数はタイムアウトの秒数です。

おわりに

オプションを見るだけでも分かるように、cURLは他にも相当色々な事が出来そうです。
「Curl」だと別のプログラミング言語の事をさしてしまうので注意。

• cURL公式
• cURL – Wikipedia