README

此设计旨在使 PHP 使用 TripAdvisor 评论 API 变得简单。

例如，可以使用 composer 进行安装

composer require exussum12/trip-advisor

然后获取评论的最简单方法如下

$reviews = new exussum12\TripAdvisor\Reviews('your key', 'your secret');
foreach ($reviews->get() as $review) {
    //handle review
}

API 以每页最多 1000 条评论进行分页，这全部由系统透明处理，只在内部请求数据时进行分页。

您可以通过执行 $reviews->limit(50); 来设置页面大小。这将请求更小的数据块。如果您只想获取特定大小的数据，请使用 $reviews->get()->getArray()，这将只发送一个请求。

如果您试图更新现有数据，请使用日期范围，例如 $reviews->since(new DateTime('2017-01-01'))

这将仅返回新的评论。

选项

所有选项都可以链接在一起，例如

$reviews->offset(100)->limit(50)->since(new DateTime('2017-01-31'));
foreach ($reviews->get() as $review) {
    //handle review
}

在此过程中可能会出现一些问题，异常名称是我能想到的最佳名称，所有异常都扩展自 exussum12\TripAdvisor\Exceptions\BaseException。

返回的评论是不可变的，因此尝试写入任何评论都会抛出异常（ImmutableObjectException）