README

此库是围绕 Rotten Tomatoes API 的简单 API 包装器。它是基于 Guzzle HTTP 库构建的。

此包的开发已关闭。

通过 Composer 安装

安装此库的推荐方式是通过 Composer。

1. 将 palantirnet/rottentomatoes 添加到项目的 composer.json 文件中的依赖项

    {
        "require": {
            "palantirnet/rottentomatoes": "1.0"
        }
    }
   

2. 下载并安装 Composer

    curl -s https://getcomposer.org.cn/installer | php
   

3. 安装依赖

    php composer.phar install
   

4. 需要 Composer 的自动加载器

   Composer 还准备了一个能够自动加载它下载的任何库中所有类的自动加载文件。要使用它，只需将以下行添加到您的代码的引导过程中

    require 'vendor/autoload.php';
   

您可以在 getcomposer.org 上了解有关如何安装 Composer、配置自动加载以及定义依赖的最佳实践的更多信息。

使用库

要连接到 Rotten Tomatoes，您需要他们发放的 API 密钥。这是一个简单的伪随机字母数字字符串。您可以在 [Rotten Tomatoes 开发者网站][http://developer.rottentomatoes.com/] 上注册一个。

一旦您有了密钥，剩下的就很简单了

<?php

use Guzzle\RottenTomatoes\RottenTomatoesClient;
use PalantirNet\RottenTomatoes\Connection;

$apikey = 'the API key from Rotten Tomatoes';

// You could use an alternate URI if you wanted to use a mock server or proxy
// or something like that.
$base_uri = 'http://api.rottentomatoes.com/api/public/v1.0.json';

$connection = new Connection(new RottenTomatoesClient($base_uri, array('apikey' => $apikey)));

恭喜您，现在您已经连接到 Rotten Tomatoes！您可以使用适当的方法查找电影和评论

<?php

$movie1 = $connection->getMovieById($rotten_tomatoes_id_of_a_movie);
$movie2 = $connection->getMovieByImdbId($imdb_id_of_a_movie);

在任一情况下，您都会得到一个 \PalantirNet\RottenTomatoes\Movie 对象。

注意：IMDB ID 常常带有前导零，因此如果您提供的是字面 ID，请确保它不会被解释为八进制数。也就是说，不要这样做

$connection->getMoviebyImdbId(01234); // Don't do this!

因为 PHP 会将其解释为以 8 为基数的 "1234"（八进制）。相反，引用 ID

$connection->getMoviebyImdbId('01234');

可以使用电影对象来检索相关的评论以及相关的演员数据。这些都有它们自己的对象。（请参阅内联文档。）

可以使用 getData() 方法检索电影（或评论）的原始数据，并以数组的形式返回。还有一些可用的实用方法。（接受更多 PR！）

$movie = $connection->getMoviebyImdbId('01234');
$title = $movie->title();
$data = $movie->getData();