29.8. Zend_Service_Yahoo

29.8.1. 简介

Zend_Service_Yahoo 是一个实现多个Yahoo! REST 接口的API. Zend_Service_Yahoo 允许你使用Yahoo! 网页搜索, Yahoo! 新闻, Yahoo! 本地(Local), Yahoo! 图片. 为了使用 Yahoo! REST API, 你必须拥有一个 Yahoo! Application ID. 要获得它, 请访问 Application ID Request Form.

29.8.2. 用Yahoo!来搜索网页

Zend_Service_Yahoo 允许你用 webSearch() 方法来进行Yahoo! 网页搜索, 它接受一个查询字符串作为参数 , 用一个可选的数组传递搜索选项. 更多的细节和搜索选项的信息, 请访问 Yahoo! Web Search Documentation. webSearch() 方法返回一个 Zend_Service_Yahoo_WebResultSet 对象.

例 29.32. 用Yahoo!来搜索网页

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

29.8.3.  用Yahoo!来查找图片

你可以使用Zend_Service_YahooimageSearch() 方法来在Yahoo上搜索图片。 。 它接受一个查询字符串作为参数 ,用一个可选的数组传递搜索选项, 就像 webSearch() method. 更多的细节和搜索选项的信息, 请访问 Yahoo! Image Search Documentation.

例 29.33. 用Yahoo!来查找图片

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

29.8.4. Finding Local Businesses and Services with Yahoo!

You can search for local businesses and services with Yahoo! by using the localSearch() method. For full details, please see the Yahoo! Local Search Documentation.

例 29.34. 用Yahoo!查找本地商务和服务信息

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

29.8.5. 搜索Yahoo! 新闻

搜索Yahoo! 新闻非常简单; 使用 newsSearch() 方法, 如下面的例子. 更多的细节和搜索选项的信息, 请访问 Yahoo! News Search Documentation.

例 29.35. 搜索Yahoo! 新闻

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

29.8.6. Zend_Service_Yahoo 类

不同的Yahoo! 搜索类型会返回下面的这些类. 每个搜索类型返回指定类型的结果集, 我们可以很方便的对它们进行遍历, 每个结果被包含在一种类型的结果集对象中. 所有这些对象都实现了 SeekableIterator 接口, 可以很容易的进行遍历和寻找指定结果。

29.8.6.1. Zend_Service_Yahoo_ResultSet

每类搜索特定的结果集都由这个基类扩展而成

每类搜索特定的结果集都会返回这个搜索特定的 Zend_Service_Yahoo_Result 对象.

29.8.6.1.1. Zend_Service_Yahoo_ResultSet::totalResults()

int totalResults();

返回搜索结果的数量

29.8.6.1.2. Properties

表 29.15. Zend_Service_Yahoo_ResultSet

名称 类型 描述
totalResultsAvailable int 所有找到的结果的数量
totalResultsReturned int 当前结果集中结果的数量
firstResultPosition int 当前结果集中的第一条在所有结果中的相对位置

Back to Class List

29.8.6.2. Zend_Service_Yahoo_WebResultSet

Zend_Service_Yahoo_WebResultSet 代表 Yahoo! 网页搜索的结果集.

[注意] 注意

Zend_Service_Yahoo_WebResultSet 扩展自 Zend_Service_Yahoo_ResultSet

Back to Class List

29.8.6.3. Zend_Service_Yahoo_ImageResultSet

Zend_Service_Yahoo_ImageResultSet 代表一个 Yahoo! 图片搜索结果集

[注意] 注意

Zend_Service_Yahoo_ImageResultSet 扩展自 Zend_Service_Yahoo_ResultSet

Back to Class List

29.8.6.4. Zend_Service_Yahoo_LocalResultSet

Zend_Service_Yahoo_LocalResultSet 代表一个Yahoo!本地搜索的结果集

表 29.16. Zend_Service_Yahoo_LocalResultSet 属性

名称 类型 描述
resultSetMapURL string 包含返回查询结果地图的URL
[注意] 注意

Zend_Service_Yahoo_LocalResultSet 扩展自 Zend_Service_Yahoo_ResultSet

Back to Class List

29.8.6.5. Zend_Service_Yahoo_NewsResultSet

Zend_Service_Yahoo_NewsResultSet 代表一个Yahoo!新闻搜索结果的集合

[注意] 注意

Zend_Service_Yahoo_NewsResultSet 扩展自 Zend_Service_Yahoo_ResultSet

Back to Class List

29.8.6.6. Zend_Service_Yahoo_Result

每类搜索特定的结果都由这个基类扩展而成

29.8.6.6.1. Properties

表 29.17. Zend_Service_Yahoo_Result Properties

名称 类型 描述
Title string 结果项的标题
Url string 结果项的url
ClickUrl string 链接到结果项的url

Back to Class List

29.8.6.7. Zend_Service_Yahoo_WebResult

每一个网页搜索结果作为一个 Zend_Service_Yahoo_WebResult 对相返回.

29.8.6.7.1. 属性

表 29.18. Zend_Service_Yahoo_WebResult 属性

名称 类型 描述
Summary string 返回结果的摘要
MimeType string 返回结果的mimetype
ModificationDate string 一个以 UNIX timestamp 表示的最后修改日期.
CacheUrl string 返回结果Yahoo! 网页搜索缓存页面的URL
CacheSize int Cache 项目的大小

Back to Class List

29.8.6.8. Zend_Service_Yahoo_ImageResult

每一个图片搜索结果作为一个 Zend_Service_Yahoo_ImageResult 对相返回.

29.8.6.8.1. 属性

表 29.19. Zend_Service_Yahoo_ImageResult 属性

名称 类型 描述
Summary string 返回结果的摘要
RefererUrl string 图片引用页的URL
FileSize int 以bytes为单位的图片大小
FileFormat string 图片的格式 (bmp, gif, jpeg, png, etc.)
Height int 图片的高
Width int 图片的宽
Thumbnail Zend_Service_Yahoo_Image 图片的缩略图

Back to Class List

29.8.6.9. Zend_Service_Yahoo_LocalResult

每一个本地搜索结果以 Zend_Service_Yahoo_LocalResult 对相返回.

29.8.6.9.1. 属性

表 29.20. Zend_Service_Yahoo_LocalResult 属性

名称 类型 描述
Address string 搜索结果的街道地址
City string 搜索结果所在的城市
State string 搜索结果所在的州
Phone string 搜索结果相关的电话号码
Rating int 用户对该结果的评分
Distance float 从你指定的位置到搜索结果的距离
MapUrl string 搜索结果地图的URL
BusinessUrl string 商务网站的URL (如果知道的话)
BusinessClickUrl string 链接到商务网站的URL (如果知道的话)

Back to Class List

29.8.6.10. Zend_Service_Yahoo_NewsResult

每一个新闻搜索结果作为一个 Zend_Service_Yahoo_NewsResult 对相返回.

29.8.6.10.1. 属性

表 29.21. Zend_Service_Yahoo_NewsResult 属性

名称 类型 描述
Summary string 返回结果的摘要
NewsSource string 发布文章的公司
NewsSourceUrl string 发布文章的公司的URL
Language string 文章所用的语言
PublishDate string 用 UNIX timestamp表示的文章发布日期
ModificationDate string 用 UNIX timestamp表示的文章最后更新日期
Thumbnail Zend_Service_Yahoo_Image 文章的缩略图,如果有的话

Back to Class List

29.8.6.11. Zend_Service_Yahoo_Image

所有的Yahoo!图片和新闻搜索返回的图片都作为 Zend_Service_Yahoo_Image 对相返回

29.8.6.11.1. Properties

表 29.22. Zend_Service_Yahoo_Image Properties

名称 类型 描述
Url string 图片URL
Width int 图片的宽
Height int 图片的高

Back to Class List