Zend_Service_Yahoo
est une API simple pour utiliser les
APIs REST de Yahoo! Zend_Service_Yahoo
vous permet de rechercher
dans Yahoo! Web Search, Yahoo! News, Yahoo! Local et Yahoo! Images. Pour pouvoir
utiliser l'API REST de Yahoo!, vous devez avoir un identifiant Yahoo Application. Pour
obtenir un identifiant Yahoo Application, veuillez compléter et soumettre le formulaire de demande d'identifiant Yahoo!
Application.
Zend_Service_Yahoo
vous permet d'effectuer des recherches
sur le net avec Yahoo! en utilisant la méthode webSearch()
, qui accepte une
chaîne de requête en paramètre, et un tableau d'options de recherche comme second
paramètre. Pour la liste détaillée des options, veuillez vous référer à la documentation
Yahoo! Web
Search. La méthode webSearch()
retourne un objet
Zend_Service_Yahoo_WebResultSet
.
Exemple 870. Rechercher sur le Web avec Yahoo!
$yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO"); $results = $yahoo->webSearch('PHP'); foreach ($results as $result) { echo $result->Title .'<br />'; }
Vous pouvez rechercher des images avec Yahoo! en utilisant la méthode
imageSearch()
de Zend_Service_Yahoo
. Cette méthode
accepte une chaîne de requête en paramètres, et un tableau d'options en second paramètre
optionnel. Pour la liste complète des options, veuillez vous référer à la documentation
Yahoo! Image
Search.
Exemple 871. Trouver des images avec Yahoo!
$yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO"); $results = $yahoo->imageSearch('PHP'); foreach ($results as $result) { echo $result->Title .'<br />'; }
Vous pouvez rechercher des vidéos avec Yahoo! en utilisant la méthode
videoSearch()
de Zend_Service_Yahoo
. Pour la liste
complète des options, veuillez vous référer à la documentation Yahoo! Video
Search.
Exemple 872. Trouver des vidéos avec Yahoo!
$yahoo = new Zend_Service_Yahoo("YAHOO_APPLICATION_ID"); $results = $yahoo->videoSearch('PHP'); foreach ($results as $result) { echo $result->Title .'<br />'; }
Vous pouvez rechercher des entreprises et des services locaux avec Yahoo!, en
utilisant la méthode localSearch()
. Pour plus de détails, veuillez vous
référer à la documentation Yahoo! Local
Search.
Exemple 873. Trouver des entreprises locales et des services avec Yahoo!
$yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO"); $results = $yahoo->localSearch('Ordinateurs Apple', array('zip' => '95014')); foreach ($results as $result) { echo $result->Title .'<br />'; }
Rechercher dans Yahoo! News est simple, il vous suffit simplement d'utiliser la
méthode newsSearch()
, comme le montre l'exemple suivant. Pour plus de
détails, veuillez vous référer à la documentation Yahoo! News
Search.
Exemple 874. Recherche dans Yahoo! News
$yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO"); $results = $yahoo->newsSearch('PHP'); foreach ($results as $result) { echo $result->Title .'<br />'; }
Rechercher avec Yahoo! Site Explorer Inbound Links est simple, il vous suffit
simplement d'utiliser la méthode inlinkDataSearch()
comme le montre
l'exemple suivant. Pour plus de détails, veuillez vous référer à la documentation Yahoo! Site
Explorer Inbound Links Documentation.
Exemple 875. Recherche avec Yahoo! Site Explorer Inbound Links
$yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO"); $results = $yahoo->inlinkDataSearch('http://framework.zend.com/'); foreach ($results as $result) { echo $result->Title .'<br />'; }
Rechercher avec Yahoo! Site Explorer's PageData est simple, il vous suffit
simplement d'utiliser la méthode pageDataSearch()
comme le montre l'exemple
suivant. Pour plus de détails, veuillez vous référer à la documentation Yahoo! Site
Explorer PageData Documentation.
Exemple 876. Recherche avec Yahoo! Site Explorer's PageData
$yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO"); $results = $yahoo->pageDataSearch('http://framework.zend.com/'); foreach ($results as $result) { echo $result->Title .'<br />'; }
Les classes sont toutes retournées par les diverses recherches Yahoo!. Chaque type
de recherche retourne un jeu de résultat spécifique sur lequel on peut facilement
itérer, avec chaque résultat contenu dans un résultat du type de l'objet. Toutes les
classes de jeu de résultat implémentent l'interface SeekableIterator
,
permettant des itérations et une recherche sur un résultat particulier.
Chaque jeu de résultat spécifique à la recherche est étendu de cette classe de base.
Chaque jeu de résultat spécifique à la recherche retourne un objet Zend_Service_Yahoo_Result spécifique à la recherche.
int totalResults();
Retourne le nombre de résultats retourné par la recherche.
Tableau 155. Zend_Service_Yahoo_ResultSet
Nom | Type | Description |
---|---|---|
totalResultsAvailable | int | Nombre total de résultats trouvés. |
totalResultsReturned | int | Nombre de résultats pour le jeu de résultat courant. |
firstResultPosition | int | Position du premier résultat dans ce jeu, par rapport au nombre total des résultats. |
Zend_Service_Yahoo_WebResultSet
représente un jeu de
résultat Yahoo! Web Search.
Note
Zend_Service_Yahoo_WebResultSet
étend Zend_Service_Yahoo_ResultSet.
Zend_Service_Yahoo_ImageResultSet
représente un jeu de
résultat Yahoo! Image Search.
Note
Zend_Service_Yahoo_ImageResultSet
étend Zend_Service_Yahoo_ResultSet
Zend_Service_Yahoo_VideoResultSet
représente un jeu de
résultat Yahoo! Video Search.
Note
Zend_Service_Yahoo_VideoResultSet
étend Zend_Service_Yahoo_ResultSet
Zend_Service_Yahoo_LocalResultSet
représente un jeu de
résultats Yahoo! Local Search.
Tableau 156. Propriétés de Zend_Service_Yahoo_LocalResultSet
Nom | Type | Description |
---|---|---|
resultSetMapURL | string | L'URL de la page Web contenant une carte graphique contenant tous les résultats affichés dessus. |
Note
Zend_Service_Yahoo_LocalResultSet
étend Zend_Service_Yahoo_ResultSet
Zend_Service_Yahoo_NewsResultSet
représente un jeu de
résultat Yahoo! News Search.
Note
Zend_Service_Yahoo_NewsResultSet
étend Zend_Service_Yahoo_ResultSet
Zend_Service_Yahoo_InlinkDataResultSet
représente un
jeu de résultat Yahoo! Inbound Link Search.
Note
Zend_Service_Yahoo_InlinkDataResultSet
étend Zend_Service_Yahoo_ResultSet
Zend_Service_Yahoo_PageDataResultSet
représente un jeu
de résultat Yahoo! PageData Search.
Note
Zend_Service_Yahoo_PageDataResultSet
étend Zend_Service_Yahoo_ResultSet
Chaque résultat spécifique à la recherche est étendu de cette classe de base.
Chaque résultat d'une recherche Web est retourné comme un objet
Zend_Service_Yahoo_WebResult
.
Tableau 158. Propriétés de Zend_Service_Yahoo_WebResult
Nom | Type | Description |
---|---|---|
Summary | string | Sommaire du résultat |
MimeType | string | type Mime du résultat |
ModificationDate | string | Timestamp UNIX de la date de la dernière modification du résultat. |
CacheUrl | string | URL Yahoo! du cache Web du résultat, s'il existe. |
CacheSize | int | Taille du cache. |
Chaque recherche d'image est retournée comme un objet
Zend_Service_Yahoo_ImageResult
.
Tableau 159. Propriétés de Zend_Service_Yahoo_ImageResult
Nom | Type | Description |
---|---|---|
Summary | string | Sommaire du résultat |
RefererUrl | string | L'URL de la page qui contient l'image |
FileSize | int | La taille (en octets) de l'image |
FileFormat | string | Le format de l'image (bmp, gif, jpeg, png, etc.) |
Height | int | La hauteur de l'image |
Width | int | LA largeur de l'image |
Thumbnail | Zend_Service_Yahoo_Image | Vignette de l'image |
Chaque recherche de vidéo est retournée comme un objet
Zend_Service_Yahoo_VideoResult
.
Tableau 160. Propriétés de Zend_Service_Yahoo_VideoResult
Nom | Type | Description |
---|---|---|
Summary | string | Sommaire du résultat |
RefererUrl | string | L'URL de la page qui contient la vidéo |
FileSize | int | La taille (en octets) de la vidéo |
FileFormat | string | Le format de la vidéo (avi, flash, mpeg, msmedia, quicktime, realmedia, etc.) |
Height | int | La hauteur de la vidéo en pixels |
Width | int | La largeur de la vidéo en pixels |
Duration | int | La durée de la vidéo en secondes |
Channels | int | Nombre de canaux audio de la vidéo |
Streaming | boolean | La vidéo est-elle en streaming ou pas ? |
Thumbnail | Zend_Service_Yahoo_Image | Vignette de la vidéo |
Chaque résultat de recherche locale est retourné dans un objet
Zend_Service_Yahoo_LocalResult
.
Tableau 161. Propriétés de Zend_Service_Yahoo_LocalResult
Nom | Type | Description |
---|---|---|
Address | string | Adresse de la rue du résultat |
City | string | Ville dans laquelle réside le résultat |
State | string | État dans lequel réside le résultat |
Phone | string | Numéro de téléphone du résultat |
Rating | int | Appréciation des utilisateurs pour ce résultat |
Distance | float | Distance entre l'endroit où vous vous trouvez et le résultat |
MapUrl | string | L'URL d'une carte pour le résultat |
BusinessUrl | string | L'URL du site de l'entreprise, s'il est connu |
BusinessClickUrl | string | L'URL pour faire un lien sur le site de l'entreprise, s'il est connu |
Chaque résultat de News Search est retourné comme un objet
Zend_Service_Yahoo_NewsResult
.
Tableau 162. Propriétés de Zend_Service_Yahoo_NewsResult
Nom | Type | Description |
---|---|---|
Summary | string | Sommaire du résultat |
NewsSource | string | L'entreprise qui a distribué l'article |
NewsSourceUrl | string | L'URL de l'entreprise qui a distribué l'article |
Language | string | La langue de l'article |
PublishDate | string | La date de publication de l'article, au format timestamp UNIX |
ModificationDate | string | La date de la dernière modification de l'article, au format timestamp UNIX |
Thumbnail | Zend_Service_Yahoo_Image | Miniature de l'image pour cet article, si elle existe |
Chaque résultat de Inbound Link Search est retourné comme un objet
Zend_Service_Yahoo_InlinkDatabResult
.
Chaque résultat de Page Data Search est retourné comme un objet
Zend_Service_Yahoo_PageDataResult
.