简单的例子

执行搜索很简单;它基本上看起来像这样：

include_once __DIR__ . '/vendor/autoload.PHP';

$GCSE_API_KEY = "nqwkoigrhe893utnih_gibberish_q2ihrgu9qjnr";
$GCSE_SEARCH_ENGINE_ID = "937592689593725455:msi299dkne4de";

$client = new Google_Client();
$client->setApplicationName("My_App");
$client->setDeveloperKey($GCSE_API_KEY);
$service = new Google_Service_Customsearch($client);
$optParams = array("cx"=>self::GCSE_SEARCH_ENGINE_ID);    
$results = $service->cse->listCse("lol cats",$optParams);

结果对象实现了Iterator,所以我们可以如下循环遍历它们：

foreach($results->getItems() as $k=>$item){
    var_dump($item);
}

Google先决条件

为了使用这个库,你必须首先设置一些google的东西.这些东西最终在Google API Client Libraries PHP (Beta)网站上提到,但你必须点击&挖掘他们,即使如此,你会错过下面的最后一个：

>您将需要一个自定义搜索引擎.不要因为互联网上大多数引用到自定义搜索引擎的用户都不想做程序搜索的事实而感到困惑.你需要一个,他们很容易在这里设置：https://cse.google.com/cse/all
>您将需要一个Google Project.再一次,当你知道去哪里时,设置很简单：https://console.developers.google.com/apis/dashboard
>您将需要一个API密钥(也称为开发人员密钥).如果您还没有一个,请到这里创建一个新的密钥：https://console.developers.google.com/apis/credentials
>您将需要为您的项目启用Google自定义搜索.此时,您可以向Google查询,但如果尚未启用Google自定义搜索项目,则可能会收到错误回复.转到信息中心,点击蓝色的“启用API”链接,搜索Google自定义搜索并启用它. https://console.developers.google.com/apis/dashboard

一个全面评论的例子

这是比上面的例子更实际的例子.它仍然很简单,但是通过许多解释性的评论,可以通过两种不同的方式来解释新的东西总是很好.

<?PHP

include_once __DIR__ . '/vendor/autoload.PHP';

/**
 * Retrieves a simple set of google results for a given plant id.
 */
class GoogleResults implements IteratorAggregate {

    // Create one or more API keys at https://console.developers.google.com/apis/credentials
  const GCSE_API_KEY = "nqwkoigrhe893utnih_gibberish_q2ihrgu9qjnr";

    /* The search engine id is specific to each "custom search engine"
     * you have configured at https://cse.google.com/cse/all     

     * Remember that you must have enabled Custom Search API for the project that
     * contains your API Key.  You can do this at the following url:
     * https://console.developers.google.com/apis/api/customsearch.googleapis.com/overview?project=vegfetch-v01&duration=PT1H    

     * If you fail to enable the Custom Search API before you try to execute a search
     * the exception that is thrown will indicate this.  */
    const GCSE_SEARCH_ENGINE_ID = "937592689593725455:msi299dkne4de";

    // Holds the GoogleService for reuse
    private $service;

    // Holds the optParam for our search engine id
    private $optParamSEID;

    /**
     * Creates a service object for our Google Custom Search.  The API key is 
     * permiently set,but the search engine id may be changed when performing 
     * searches in case you want to search across multiple pre-prepared engines.
     * 
     * @param string $appName       Optional name for this google search
     */
    public function __construct($appName = "My_Search") {

        $client = new Google_Client();

        // application name is an arbitrary name
        $client->setApplicationName($appName);

        // the developer key is the API Key for a specific google project
        $client->setDeveloperKey(self::GCSE_API_KEY);

        // create new service
        $this->service = new Google_Service_Customsearch($client);

        // You must specify a custom search engine.  You can do this either by setting
        // the element "cx" to the search engine id,or by setting the element "cref"
        // to the public url for that search engine.
        // 
        // For a full list of possible params see https://github.com/google/google-api-PHP-client-services/blob/master/src/Google/Service/Customsearch/Resource/Cse.PHP
        $this->optParamSEID = array("cx"=>self::GCSE_SEARCH_ENGINE_ID);

  }

    /**
     * A simplistic function to take a search term & search options and return an 
     * array of results.  You may want to 
     * 
     * @param string    $searchTerm     The term you want to search for
     * @param array     $optParams      See: For a full list of possible params see https://github.com/google/google-api-PHP-client-services/blob/master/src/Google/Service/Customsearch/Resource/Cse.PHP
     * @return array                                An array of search result items
     */
  public function getSearchResults($searchTerm,$optParams = array()){
        // return array containing search result items
        $items = array();

        // Merge our search engine id into the $optParams
        // If $optParams already specified a 'cx' element,it will replace our default
        $optParams = array_merge($this->optParamSEID,$optParams);

        // set search term & params and execute the query
        $results = $this->service->cse->listCse($searchTerm,$optParams);

        // Since cse inherits from Google_Collections (which implements Iterator)
        // we can loop through the results by using `getItems()`
        foreach($results->getItems() as $k=>$item){
            var_dump($item);
            $item[] = $item;
        }

        return $items;
  }
}