Zend_Service_Flickr
est une API simple pour utiliser le service Wev REST de Flick. Pour
pouvoir utiliser lew services Web Flickr, vous devez avoir une clé d'utilisation de l'API. Pour obtenir
une telle clé, et pour plus d'information sur le service Web REST de Flickr, veuillez vous référrez à la
documentation de l'API Flickr.
Dans l'exemple suivant, nous allons utiliser la méthode tagSearch()
pour rechercher des photos
ayant "php" dans les tags.
Exemple 13.8. Simple recherche de photos sur Flickr
<?php require_once 'Zend/Service/Flickr.php'; $flickr = new Zend_Service_Flickr('MA_CLE_API'); $results = $flickr->tagSearch("php"); foreach ($results as $result) { echo $result->title . '<br />'; } ?>
Note | |
---|---|
tagSearch() accepte un tableau d'options comme second paramètre optionnel.
|
Zend_Service_Flickr
fournit 3 façons différentes de récupérer des informations sur les
utilisateurs.
userSearch()
: Accepte une chaîne de caractère de balise délimitée par des espaces, et
un tableau d'options en second paramère optionnel. Elle retourne un objet Zend_Service_Flickr_ResultSet
.
getIdByUsername()
: Retourne l'identifiant utilisateur, correspondant à son nom d'utilisateur.
getIdByEmail()
: Retourne l'identifiant utilisateur correspondant à l'adresse email donnée.
Exemple 13.9. Trouver un utilisateur Flickr par son adresse email
Dans cet exemple, nous havons une adresse email d'un utilisateur Flickr, et nous récupérons ses informations
utilisateurs en utilisant la méthode userSearch()
:
<?php require_once 'Zend/Service/Flickr.php'; $flickr = new Zend_Service_Flickr('MA_CLE_API'); $results = $flickr->userSearch($userEmail); foreach ($results as $result) { echo $result->title . '<br />'; } ?>
Zend_Service_Flickr
permet de récupérer facilement et rapidement, les détails d'une image
grâce à son ID. Utilisez simplement la méthode getImageDetails()
, comme dans l'exemple suivant :
Exemple 13.10. Récupérer les détails d'une image
Une fois que vous avez l'identifiant de l'image Flickr, il est simple de retrouver les informations qui lui sont associées :
<?php require_once 'Zend/Service/Flickr.php'; $flickr = new Zend_Service_Flickr('MA_CLE_API'); $image = $flickr->getImageDetails($imageId); echo "ID de l'image : $imageId, taille : $image->width x $image->height pixels.<br />\n"; echo "<a href=\"$image->clickUri\">Clicker pour l'image</a>\n"; ?>
Les classes suivantes sont toutes retournées par tagSearch()
et userSearch()
:
Représente le jeu de résultats d'une recherche sur Flickr.
Note | |
---|---|
Implémente l'itérateur |
int totalResults();
Retourne le nombre de totale de résultats dans ce jeu de résultats.
Un seule image résultant d'une requête sur Flickr.
Tableau 13.11. Propriétés Zend_Service_Flickr_Result
Nom | Type | Description |
---|---|---|
id | int | Identifiant de l'image |
owner | int | Le NSID du propriétaire de la photo. |
secret | string | La clé utilisée dans la construction de l'URL. |
server | string | Le nom du serveur à utiliser pour construire l'URL. |
title | string | Le titre de la photo. |
ispublic | boolean | La photo est publique. |
isfriend | boolean | Vous pouvez voir la photo parce que vous êtes un ami du propriétaire de cette photo. |
isfamily | boolean | Vous pouvez voir la photo parce que vous êtes de la famille du propriétaire de cette photo. |
license | string | La licence sous laquelle cette photo est disponible. |
date_upload | string | La date à laquelle la photo a été uploadée. |
date_taken | string | La date à laquelle la photo a été prise. |
owner_name | string | Le ??? screenname ??? du propriétaire de la photo. |
icon_server | string | Le serveur utilisé pour l'assemblage des ??? icon URLs ???. |
Square | Zend_Service_Flickr_Image | Une miniature de l'image au format 75x75 pixels. |
Thumbnail | Zend_Service_Flickr_Image | Une miniature de l'image de 100 pixels. |
Small | Zend_Service_Flickr_Image | Une version en 240 pixels de l'image. |
Medium | Zend_Service_Flickr_Image | Une version en 500 pixel version de l'image. |
Large | Zend_Service_Flickr_Image | Une version en 640 pixel version de l'image. |
Original | Zend_Service_Flickr_Image | L'image originale. |
Représente une image retournée pour une recherche Flickr.