philip / bingimagesearch
使用Bing图片搜索API查找图片,并可选择性缓存结果
dev-master
2016-08-15 06:04 UTC
Requires
- php: >=5.3.2
- ext-sqlite3: *
This package is not auto-updated.
Last update: 2024-09-14 18:37:01 UTC
README
使用Bing图片搜索API获取图片。
API密钥
要使用Bing图片搜索,您需要一个Bing API密钥。免费版每月允许5000次查询。要获取此密钥,请访问http://www.bing.com/toolbox/bingsearchapi 并申请密钥。这是一个简单的过程。它是“Windows Azure Marketplace”的一部分。
此密钥也可以用于其他搜索类型(例如,网页)但我们用它来执行图片搜索。
在“账户信息”下,您将看到“主要账户密钥”,这是您的Bing API密钥。
示例
在examples/
目录中有几个示例,但这里还有一个基于cat.php
的示例。
<?php require __DIR__ . "/../src/BingImageSearch.php"; $bing = new Philip\BingImageSearch(); // Settings $bing->setApiKey("YOUR KEY HERE"); $bing->setQuery("Happy Cat"); // Let's retrieve the first image, as JSON $image_json = $bing->pickFirstImage(); // Output image as HTML $html = $bing->outputImageHtml($image_json, 'main'); echo $html;
要求
Bing API密钥、启用了JSON扩展的PHP(默认情况下是启用的)。可选地,使用SQLite3扩展来缓存结果。
安装
使用Composer
$ composer require philip/bingimagesearch
或者,简单地下载它并使用
$ wget https://github.com/philip/BingImageSearch/archive/master.zip
$ unzip master.zip
$ mv BingImageSearch-master BingImageSearch
$ cd BingImageSearch
$ php examples/cat.php
在设置Bing API密钥之前,执行将失败。未来的版本将使这一过程变得更简单,但到目前为止,您必须编辑代码。在上面的例子中,这意味着向cat.php
添加API密钥。