philip/bingimagesearch

使用Bing图片搜索API查找图片,并可选择性缓存结果

dev-master 2016-08-15 06:04 UTC

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密钥。