Récupérer une image sur Amazon avec Zend Framework

Récemment, j'avais jeté un coup d'oeil à l'API d'Amazon pour voir de quelle façon je pouvais reproduire un comportement semblable à la fonctionnalité de programmingbooks.org, qui récupère les informations d'un produit recherché et qui copie localement l'image affichée sur Amazon.

Ceci peut être possible grâce à Amazon Web Services qui offre un outil pour faire des requêtes en tout genre sur le contenu. Pour des raisons légales, comme le service nous fournit l'information, on doit en retour faire un lien vers la page du produit.

Pour pouvoir utiliser l'API, on doit d'abord se créer un compte pour obtenir une clé d'accès. Il suffit de s'inscrire, d'accepter les termes et conditions (courtes, lecture recommandée) et d'activer son compte à l'aide du lien d'activation reçu par courriel. Une fois identifié, on obtiendra la clé à utiliser dans notre code dans l'encadré "Your Access Key ID".

Une fois en possession de la clé d'accès, on peut utiliser des librairies pour manipuler les requêtes à Amazon. Ici, Zend Framework nous simplifie beaucoup le travail avec son composant Zend_Service_Amazon.

Après avoir mis à jour ZF pour la plus récente version 1.8.0 (qui contient plusieurs ajouts intéressants), j'ai créé un petit script PHP. On doit inclure le service Amazon et instancier un objet en utilisant la clé d'accès obtenue.

require_once('Zend/Service/Amazon.php');

$service = new Zend_Service_Amazon(ENTREZ_VOTRE_CLE_ICI);

Appelez la méthode itemSearch() et indiquez dans quelle section vous voulez lancer la recherche (Music, Books, etc) et spécifiez les mots clés. Le ResponseGroup indique quels éléments doivent être retournés par Amazon. Pour mes besoins, j'ai mis le strict minimum, soit l'information générique sur le produit. L'important est d'inclure dans la réponse "Images".

$results = $service->itemSearch(
 array(
    'SearchIndex'   => 'Music',
    'Keywords'      => 'Metallica Master of puppets',
    'ResponseGroup' => 'Small,ItemAttributes,Images'
 )
);

La variable $results n'est pas un array, c'est un objet Zend_Service_Amazon_ResultSet. Donc pour voir si quelque chose nous est retourné, on doit vérifier totalResults() plutôt que faire un count(). L'objet permet d'être traversé et comme je n'ai besoin que du premier (j'assume que l'image proposée est la bonne), j'appelle current() qui me positionne au premier élément du ResultSet. Les propriétés d'un item seront accédées avec la flèche : DetailPageURL, Title, SmallImage, MediumImage, LargeImage, Subjects, etc.

if( $results->totalResults() > 0 ){
 $item = $results->current();

 echo $item->Title;
 echo '<img src="' . $item->LargeImage->Url . '" />';

 // suite plus loin
}

Comme on obtient l'URL de l'image stockée sur les serveurs d'Amazon, on peut utiliser le chemin pour effectuer une capture de l'image avec CURL. Son contenu sera intercepté et stocké dans la variable $output. La propriété LargeImage de l'objet $item contient en réalité un autre objet de type Zend_Service_Amazon_Image, qui lui contient la propriété Url.

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $item->LargeImage->Url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$output = curl_exec($ch);

Comme l'URL contient le nom du fichier, je fais un petit tour de passe-passe populaire pour obtenir l'extension, bien qu'il y ait des solutions plus fiables (j'en parlerai plus tard cette semaine). J'enregistrerai le tout dans le répertoire files et j'utiliserai un nom générique pour les fins de ma démonstration.

// save file
$ext = end(explode('.', $item->LargeImage->Url));
$saveAs = 'files/image.' . $ext;

Enfin, j'utilise le contenu récupéré par CUrl pour créer un nouveau fichier sur mon serveur (permissions requises).

$fh = fopen($saveAs, 'w') or die("Impossible d'ouvrir le fichier");
fwrite($fh, $output);
fclose($fh);

En regardant la liste des services pris en charge par le Zend Framework, on voit qu'il offre d'autres classes qui facilitent l'utilisation des API de différents sites, comme Delicious, Flickr, Nirvanix, ReCaptcha, Simpy, SlideShade, StrikeIron, Technorati, Twitter et Yahoo.

Twitter ? Hum, ça semble être une solution beaucoup plus simple et transparente que celle que j'ai présenté il y a 1 mois...