Zend_Service_Delicious は、 del.icio.us の XML および JSON ウェブサービスを使用するためのシンプルな API です。 このコンポーネントによって、del.icio.us への投稿のうち、 権限を持っているものについての読み書きが可能になります。 全ユーザの公開データへの読み込み専用のアクセスも可能です。 getAllPosts(); foreach ($posts as $post) { echo "--\n"; echo "タイトル: {$post->getTitle()}\n"; echo "URL: {$post->getUrl()}\n"; } ]]> Zend_Service_Delicious には、投稿を取得するメソッドとして getPosts()、getRecentPosts() および getAllPosts() の三種類があります。 これらはすべて Zend_Service_Delicious_PostList のインスタンスを返します。ここに、取得したすべての投稿が含まれます。 Zend_Service_Delicious のメソッド getPosts()、getAllPosts()、 getRecentPosts() および getUserPosts() が、このクラスのインスタンスを返します。 データへのアクセスを簡単に行うため、このクラスは Countable、Iterator および ArrayAccess の三つのインターフェイスを実装しています。 getAllPosts(); // 投稿数を数えます echo count($posts); // 投稿を順次処理します foreach ($posts as $post) { echo "--\n"; echo "タイトル: {$post->getTitle()}\n"; echo "URL: {$post->getUrl()}\n"; } // 配列風のアクセス方式で投稿を取得します echo $posts[0]->getTitle(); ]]> メソッド ArrayAccess::offsetSet() および ArrayAccess::offsetUnset() は、この実装では例外をスローします。つまり、unset($posts[0]); や $posts[0] = 'A'; といったコードを書くと例外が発生するということです。 というのも、これらのプロパティは読み込み専用だからです。 投稿一覧オブジェクトには、二種類のフィルタリング機能が組み込まれています。 タグによるフィルタリングと、URL によるフィルタリングです。 特定のタグで投稿を絞り込むには、withTags() を使用します。 ひとつのタグでだけ絞り込みを行う際に便利なように、 withTag() も用意されています。 getAllPosts(); // タグ "php" および "zend" が指定されている投稿のみを表示します foreach ($posts->withTags(array('php', 'zend')) as $post) { echo "タイトル: {$post->getTitle()}\n"; echo "URL: {$post->getUrl()}\n"; } ]]> 指定した正規表現にマッチする URL で投稿を絞り込むには withUrl() メソッドを使用します。 getAllPosts(); // URL に "help" を含む投稿のみを表示します foreach ($posts->withUrl('/help/') as $post) { echo "タイトル: {$post->getTitle()}\n"; echo "URL: {$post->getUrl()}\n"; } ]]> getPosts(); // タイトルを設定します $posts[0]->setTitle('新しいタイトル'); // 変更を保存します $posts[0]->save(); ]]> すべての設定用メソッドは post オブジェクトを返すので、 「流れるようなインターフェイス」を使用してメソッドコールを連結できます。 getPosts(); $posts[0]->setTitle('新しいタイトル') ->setNotes('新しいメモ') ->save(); ]]> 投稿を削除する方法は二通りあります。 投稿の URL を指定するか、post オブジェクトの delete() メソッドを実行するかのいずれかです。 deletePost('http://framework.zend.com'); // あるいは、post オブジェクトのメソッドをコールします $posts = $delicious->getPosts(); $posts[0]->delete(); // deletePost() を使用する、もうひとつの方法 $delicious->deletePost($posts[0]->getUrl()); ]]> 投稿を追加するには createNewPost() メソッドをコールする必要があります。 このメソッドは Zend_Service_Delicious_Post オブジェクトを返します。 投稿を編集したら、それを del.icio.us のデータベースに保存するために save() メソッドをコールします。 createNewPost('Zend Framework', 'http://framework.zend.com') ->setNotes('Zend Framework Homepage') ->save(); // 新しい投稿を作成し、保存します (メソッドコールの連結を使用しません) $newPost = $delicious->createNewPost('Zend Framework', 'http://framework.zend.com'); $newPost->setNotes('Zend Framework Homepage'); $newPost->save(); ]]> getTags()); // タグ ZF の名前を zendFramework に変更します $delicious->renameTag('ZF', 'zendFramework'); ]]> getBundles()); // someBundle というバンドルを削除します $delicious->deleteBundle('someBundle'); // バンドルを追加します $delicious->addBundle('newBundle', array('tag1', 'tag2')); ]]> del.icio.us のウェブ API を使用すると、全ユーザの公開データにアクセスできるようになります。 名前 説明 返り値の型 getUserFans() あるユーザのファンを取得します Array getUserNetwork() あるユーザのネットワークを取得します Array getUserPosts() あるユーザの投稿を取得します Zend_Service_Delicious_PostList getUserTags() あるユーザのタグを取得します Array これらのメソッドを使用するだけなら、 Zend_Service_Delicious オブジェクトの作成時に ユーザ名とパスワードを指定する必要はありません。 getUserFans('someUser')); // someUser のネットワークを取得します print_r($delicious->getUserNetwork('someUser')); // someUser のタグを取得します print_r($delicious->getUserTags('someUser')); ]]> 公開投稿を getUserPosts() メソッドで取得すると、 Zend_Service_Delicious_PostList オブジェクトが返されます。ここには Zend_Service_Delicious_SimplePost オブジェクトが含まれ、 その中には URL やタイトル、メモ、タグといった投稿に関する基本情報が含まれます。 名前 説明 返り値の型 getNotes() 投稿のメモを返します String getTags() 投稿のタグを返します Array getTitle() 投稿のタイトルを返します String getUrl() 投稿の URL を返します String Zend_Service_Delicious は、Zend_Rest_Client を使用して del.icio.us ウェブサービスへの HTTP リクエストを作成します。 Zend_Service_Delicious が使用する HTTP クライアントを変更するには、Zend_Rest_Client の HTTP クライアントを変更する必要があります。 Zend_Service_Delicious で複数のリクエストを作成する際に それを高速化するなら、接続をキープするように HTTP クライアントを設定するとよいでしょう。 setConfig(array( 'keepalive' => true )); ]]> Zend_Service_Delicious オブジェクトを作成する際に、 Zend_Rest_Client の SSL トランスポートは 'ssl' と設定されます。デフォルトの 'ssl2' ではありません。これは、del.icio.us 側の問題で、 'ssl2' を使用するとリクエストの処理に時間がかかる (ほぼ 2 秒くらい) ためです。