Zend_Service_Delicious est une API pour accéder aux Web services XML et JSON de del.icio.us. Ce composant vous donne, si vous avez les droits, un accès en lecture-écriture à vos entrées sur del.icio.us. Il permet également un accès en lecture seule aux données de tous les utilisateurs. getAllPosts(); foreach ($posts as $post) { echo "--\n"; echo "Titre: {$post->getTitle()}\n"; echo "Url: {$post->getUrl()}\n"; } ]]> Zend_Service_Delicious fournis trois méthodes pour récupérer vos entrées : getPosts(), getRecentPosts() et getAllPosts(). Elles retournent toutes une instance de la classe Zend_Service_Delicious_PostList, qui contient toutes les entrées récupérées. Des instances de cette classe sont retournées par les méthodes getPosts(), getAllPosts(),getRecentPosts(), et getUserPosts() de Zend_Service_Delicious. Pour faciliter l'accès au données cette classe implémente les interfaces Countable, Iterator, etArrayAccess. getAllPosts(); // Affiche le nombre d'entrées echo count($posts); // Itération sur les entrées foreach ($posts as $post) { echo "--\n"; echo "Titre: {$post->getTitle()}\n"; echo "Url: {$post->getUrl()}\n"; } // Affiche une entrée en utilisant un tableau echo $posts[0]->getTitle(); ]]> Dans cette implémentation les méthodes ArrayAccess::offsetSet() et ArrayAccess::offsetUnset() lèvent des exceptions. Ainsi, du code tel que unset($posts[0]); ou $posts[0] = 'A'; lèvera une exception car ces propriétés sont en lecture seule. Les objets d'entrées ont deux capacités de filtrage incorporées. Les entrées peuvent être filtrées par étiquette et URL. Les entrées peuvent être filtrées par une (des) étiquette(s) spécifique(s) en utilisant withTags(). Par confort, withTag() est aussi fourni quand il est nécessaire 'e ne spécifier qu'une seule étiquette getAllPosts(); // Affiche les entrées ayant les étiquettes "php" et "zend" foreach ($posts->withTags(array('php', 'zend')) as $post) { echo "Title: {$post->getTitle()}\n"; echo "Url: {$post->getUrl()}\n"; } ]]> Les entrées peuvent être filtrées par URL correspondant à une expression régulière spécifiée en utilisant la méthode withUrl() : getAllPosts(); // Affiche les entrées ayant "help" dans l'URL foreach ($posts->withUrl('/help/') as $post) { echo "Title: {$post->getTitle()}\n"; echo "Url: {$post->getUrl()}\n"; } ]]> getPosts(); // change le titre $posts[0]->setTitle('Nouveau Titre'); // sauvegarde le changement $posts[0]->save(); ]]> Toutes les méthodes "setter" renvoient l'objet Zend_Service_Delicious_PostList vous pouvez donc chaîner les appels aux méthodes en utilisant une interface fluide. getPosts(); $posts[0]->setTitle('Nouveau Titre') ->setNotes('Nouvelle note') ->save(); ]]> Il y a deux moyens de supprimer une entrée, en spécifiant son URL ou en appelant la méthode delete() sur un objet Zend_Service_Delicious_PostList. deletePost('http://framework.zend.com'); // en appelant la méthode de l'objet Zend_Service_Delicious_PostList $posts = $delicious->getPosts(); $posts[0]->delete(); // une autre façon d'utiliser deletePost() $delicious->deletePost($posts[0]->getUrl()); ]]> Pour ajouter une entrée vous devez appeler la méthode createNewPost(), qui renvoie un objet Zend_Service_Delicious_Post. Quand vous éditez l'entrée, vous devez la sauvegarder dans la base de donnée de del.icio.us en appelant la méthode save(). createNewPost('Zend Framework', 'http://framework.zend.com') ->setNotes('Page d\'accueil de Zend Framework') ->save(); // créé et sauvegarde une nouvelle entrée (sans enchaîner les méthodes) $newPost = $delicious->createNewPost('Zend Framework', 'http://framework.zend.com'); $newPost->setNotes('Page d\'accueil de Zend Framework'); $newPost->save(); ]]> getTags()); // renomme l'étiquette "ZF" en "zendFramework" $delicious->renameTag('ZF', 'zendFramework'); ]]> getBundles()); // efface le groupe someBundle $delicious->deleteBundle('someBundle'); // ajoute un groupe $delicious->addBundle('newBundle', array('tag1', 'tag2')); ]]> L'API Web del.icio.us autorise l'accès aux données publiques de tous les utilisateurs. Nom Description Type de retour getUserFans() Récupère les fans d'un utilisateur Array getUserNetwork() Récupère le réseau d'un utilisateur Array getUserPosts() Récupère les entrées d'un utilisateur Zend_Service_Delicious_PostList getUserTags() Récupère les étiquettes d'un utilisateur Array Si vous utilisez uniquement ces méthodes, le nom d'utilisateur et le mot de passe ne sont pas obligatoires pour créer un nouvel objet Zend_Service_Delicious. getUserFans('someUser')); // récupère le réseau de l'utilisateur someUser print_r($delicious->getUserNetwork('someUser')); // récupère les Tags de l'utilisateur someUser print_r($delicious->getUserTags('someUser')); ]]> Quand vous récupérez des entrées publiques, la méthode getUserPosts() retourne un objet Zend_Service_Delicious_PostList qui contient des objets Zend_Service_Delicious_SimplePost. Ces derniers contiennent des informations basiques sur l'entrée : URL, title, notes, and tags. Nom Description Type de retour getNotes() Récupère les notes de l'entrée String getTags() Récupère les étiquettes de l'entrée Array getTitle() Récupère le titre de l'entrée String getUrl() Récupère l'URL de l'entrée String Zend_Service_Delicious utilise Zend_Rest_Client pour effectuer les requêtes HTTP sur le Web service de del.icio.us. Pour modifier le client HTTP utiliser par Zend_Service_Delicious, vous devez modifier le client HTTP de Zend_Rest_Client. Quand vous effectuez plus d'une requête avec Zend_Service_Delicious vous pouvez accélérez vos requêtes en configurant votre client HTTP pour qu'il ne ferme pas les connexions. setConfig(array( 'keepalive' => true )); ]]> En raison de quelques problèmes de del.icio.us avec 'ssl2' (environs 2 secondes pour une requête), quand un objet Zend_Service_Delicious est construit, le transport SSL de Zend_Rest_Client est configuré sur 'ssl' au lieu de la valeur par défaut 'ssl2'.