myThings DevelopersのチュートリアルをIBM BluemixのCloudFoundryを使いながら進めてみよう。という記事です。
myThings Developersとは
myThings Developersは、さまざまなサービス、デバイスのAPIを共通のI/Fで束ねるサービス連携プラットフォームです。
myThings Developersを活用することで、TwitterやFacebookなどのWebサービスを始め、FitbitやJawboneUPなどのウェアラブルデバイス、BOCCOのようなロボット、異なるメーカーが提供しているサービスやデバイスのAPIを共通のI/Fで利用することができ、開発負担・API学習コストを下げることことができます。
myThingsアプリという同名のスマホアプリもありますが、それとの違いはこちらを参照してください。
http://qiita.com/yamamotomanabu/items/c10e0f05d477a25ff80e
必要なもの
- Yahoo! JAPAN ID
- IBM Bluemixのアカウント
公式チュートリアルには、「プログラムの実行環境（サーバー）」が必要とあるのですが、これにIBM Bluemixを利用します。
チュートリアルの内容
ゴール
公式チュートリアルでは、myThings Developersのカスタムトリガーという機能を使って、Twitterと連携させる手順が記載されています。
それではここからは実際にmyThings Developersに触ってみます。
ステップ1
ステップ1ではサーバは利用しないので公式チュートリアルをそのまま実施しましょう。
ステップ2
ステップ2以降はサーバが必要になってくるので、公式チュートリアルを進める前にこちらの手順を済ませてサーバの準備を行います。
アプリ作成
PHPのテンプレートからアプリを作成
コマンドラインインターフェースのインストール
手順に従いダウンロード＆インストール
④の実行時に
exec: "cf": executable file not found in $PATH
と出力された場合は、以下のようにcfにパスを通してください
export PATH=$PATH:(cf-cliを解凍したパス)
サンプルコードをデプロイ
あとは公式チュートリアルに戻って、setting_sample.phpとtrigger_sample.phpを作成し、Bluemixにデプロイしましょう。
デプロイする際には以下のようにチュートリアル用のディレクトリ（ここでは"myThings-tutorial"）を作成して、CloudFoundryにおくとファイル管理しやすいです。
$ ls -al ./myThings-tutorial
total **
********** * ** ** 204 10 22 10:25 .
********** * ** ** 238 10 22 10:25 ..
********** * ** ** 5301 10 20 02:42 setting_sample.php
********** * ** ** 5570 10 20 02:42 trigger_sample.php
$ cd ./myThings-tutorial
$ cf push <Bluemixのアプリケーション名>
以降はそのまま公式チュートリアルに従ってください。また、Twitterだけでなく色々なサービスとの連携を試してみて頂ければと思います。
ステップ3
ステップ2のサンプルコードは、「myThings Developersにユーザー登録した人（Yahoo! JAPAN ID）」と「Bluemixで作成したホストにアクセスした人（アクセスしたブラウザでログインされているYahoo! JAPAN ID）」が同じする人であることが前提の内容になっています。
※違う人がアクセスすると↓こうなります。
Composerの利用
今のままでは不特定多数の方にアクセスしてもらえないので、ステップ3ではoAuthの実装を行います。チュートリアルにある通り「Yahoo! ID連携 SDK for PHP」というSDKを導入してみます。
IBM Bluemix（CloudFoundry）でもComposerを利用することができます。アプリケーションのrootにcomposer.jsonを置くことでcf push時に各種ライブラリをインストールしてくれます。
$ ls -al ./myThings-tutorial
total **
********** * ** ** 204 10 22 10:25 .
********** * ** ** 238 10 22 10:25 ..
********** * ** ** 223 10 22 17:49 composer.json
********** * ** ** 5301 10 20 02:42 setting_sample.php←STEP2の名残り。もう消して良いです
********** * ** ** 5570 10 20 02:42 trigger_sample.php←←STEP2の名残り。もう消して良いです
$ cd ./myThings-tutorial
$ cf push <Bluemixのアプリケーション名>
-こんな感じの実行ログが流れます-
（省略）
Loading composer repositories with package information
Updating dependencies
- Installing yahoojapan/yconnect-php-sdk (dev-master 251ade9)
Cloning 251ade9e2ee0d61ba539e13d85f3a9ab5911e25c
Writing lock file
（省略）
この「Yahoo! ID連携 SDK for PHP」の導入さえIBM Bluemix（CloudFoundry）に合わせたやり方に読み替えれば、あとは公式チュートリアルの内容通り、index.php、callback.php、geturl.php、setting_callback.php、customtrigger.phpといったファイルをサンプルコードそのままに作成して、動作確認を進めてください。
一点注意としては、以下のような設定例がたびたび出てくるのですが、http://www.example.com は必ずご自身の環境向けに書き換えてください。Bluemixであれば、http://（人それぞれ）.mybluemix.net のようになるはずです。
