24.5. Zend_Service_Yahoo
Précédent | Chapitre 24. Zend_Service | Suivant

## 24.5. Zend_Service_Yahoo

### 24.5.1. Introduction

`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.

### 24.5.2. Rechercher sur le Web avec Yahoo!

`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 recherches 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 24.13. Rechercher sur le Web avec Yahoo!

    <?php
    require_once 'Zend/Service/Yahoo.php';
    $yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO");
    $results = $yahoo->webSearch('PHP');
    foreach ($results as $result) {
        echo $result->Title .'<br />';
    }
    ?>

### 24.5.3. Trouver des images avec Yahoo!

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 24.14. Trouver des images avec Yahoo!

    <?php
    require_once 'Zend/Service/Yahoo.php';
    $yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO");
    $results = $yahoo->imageSearch('PHP');
    foreach ($results as $result) {
        echo $result->Title .'<br />';
    }
    ?>

### 24.5.4. Trouver des entreprises et des services locaux avec Yahoo!

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 24.15. Trouver des entreprises locales et des services avec Yahoo!

    <?php
    require_once 'Zend/Service/Yahoo.php';
    $yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO");
    $results = $yahoo->localSearch('Ordinateurs Apple', array('zip' => '95014'));
    foreach ($results as $result) {
        echo $result->Title .'<br />';
    }
    ?>

### 24.5.5. Rechercher dans Yahoo! News

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 24.16. Rechercher dans Yahoo! News

    <?php
    require_once 'Zend/Service/Yahoo.php';
    $yahoo = new Zend_Service_Yahoo("ID_APPLICATION_YAHOO");
    $results = $yahoo->newsSearch('PHP');
    foreach ($results as $result) {
        echo $result->Title .'<br />';
    }
    ?>

### 24.5.6. Classes Zend_Service_Yahoo

Les classes sont toutes retournées par les divers recherches Yahoo!. Chaque type de recherche retourne un jeu de résultat de 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.

- `Zend_Service_Yahoo_ResultSet`

- `Zend_Service_Yahoo_WebResultSet`

- `Zend_Service_Yahoo_ImageResultSet`

- `Zend_Service_Yahoo_LocalResultSet`

- `Zend_Service_Yahoo_NewsResultSet`

- `Zend_Service_Yahoo_Result`

- `Zend_Service_Yahoo_WebResult`

- `Zend_Service_Yahoo_ImageResult`

- `Zend_Service_Yahoo_LocalResult`

- `Zend_Service_Yahoo_NewsResult`

- `Zend_Service_Yahoo_Image`

#### 24.5.6.1. Zend_Service_Yahoo_ResultSet

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.

##### 24.5.6.1.1. Zend_Service_Yahoo_ResultSet::totalResults()

`int totalResults();`

Retourne le nombre de résultats retourné par la recherche.

##### 24.5.6.1.2. Propriétés

Tableau 24.13. 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.

Retour à la liste des classes

#### 24.5.6.2. Zend_Service_Yahoo_WebResultSet

`Zend_Service_Yahoo_WebResultSet` représent un jeu de résutat Yahoo! Web Search.

| Note
`Zend_Service_Yahoo_WebResultSet` étend Zend_Service_Yahoo_ResultSet.

Retour à la liste des classes

#### 24.5.6.3. Zend_Service_Yahoo_ImageResultSet

`Zend_Service_Yahoo_ImageResultSet` représente un jeu de résultat Yahoo! Image Search.

| Note
`Zend_Service_Yahoo_ImageResultSet` étend Zend_Service_Yahoo_ResultSet

Retour à la liste des classes

#### 24.5.6.4. Zend_Service_Yahoo_LocalResultSet

`Zend_Service_Yahoo_LocalResultSet` représente un jeu de résultats Yahoo! Local Search.

Tableau 24.14. 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é dessus.

| Note
`Zend_Service_Yahoo_LocalResultSet` étend Zend_Service_Yahoo_ResultSet

Retour à la liste des classes

#### 24.5.6.5. Zend_Service_Yahoo_NewsResultSet

`Zend_Service_Yahoo_NewsResultSet` représente un jeu de résultat Yahoo! News Search.

| Note
`Zend_Service_Yahoo_NewsResultSet` étend Zend_Service_Yahoo_ResultSet

Retour à la liste des classes

#### 24.5.6.6. Zend_Service_Yahoo_Result

Chaque résultat spécifique à la recherche est étendu de cette classe de base.

##### 24.5.6.6.1. Propriétés

Tableau 24.15. Propriétés de Zend_Service_Yahoo_Result

Nom | Type | Description
--- | --- | ---
Title | string | Titre du résultat
Url | string | URL du résultat
ClickUrl | string | URL pour pointer sur ce résultat

Retour à la liste des classes

#### 24.5.6.7. Zend_Service_Yahoo_WebResult

Each Web Search result is returned as a `Zend_Service_Yahoo_WebResult` object.

##### 24.5.6.7.1. Propriétés

Tableau 24.16. 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.

Retour à la liste des classes

#### 24.5.6.8. Zend_Service_Yahoo_ImageResult

Each Image Search result is returned as a `Zend_Service_Yahoo_ImageResult` object.

##### 24.5.6.8.1. Propriétés

Tableau 24.17. 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

Retour à la liste des classes

#### 24.5.6.9. Zend_Service_Yahoo_LocalResult

Chaque résultat de recherche locale est retourné dans un objet `Zend_Service_Yahoo_LocalResult`.

##### 24.5.6.9.1. Propriétés

Tableau 24.18. 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 | Etat dans lequel réside le résultat
Phone | string | Numéro de téléphone du résultat
Rating | int | Appréciation des utilisateur pour ce résultat
Distance | float | Distance entre l'endroit ou 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

Retour à la liste des classes

#### 24.5.6.10. Zend_Service_Yahoo_NewsResult

Chaque résultat de News Search est retourné comme un objet `Zend_Service_Yahoo_NewsResult`.

##### 24.5.6.10.1. Propriétés

Tableau 24.19. 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

Retour à la liste des classes

#### 24.5.6.11. Zend_Service_Yahoo_Image

Toutes les images retournées, par Yahoo! Image Search ou Yahoo! News Search sont représentées par un objet `Zend_Service_Yahoo_Image`.

##### 24.5.6.11.1. Propriétés

Tableau 24.20. Propriétés de Zend_Service_Yahoo_Image

Nom | Type | Description
--- | --- | ---
Url | string | URL de l'image
Width | int | Largeur de l'image
Height | int | Hauteur de l'image

Retour à la liste des classes

Précédent | Niveau supérieur | Suivant
24.4. Zend_Service_Flickr | Sommaire | Chapitre 25. Zend_Session