exussum12/trip-advisor

PHP implementation of review API

Trip Advisor Review Client

, _(*1)

This is designed to be an easy way in php to use the reviews API from TripAdvisor., _(*2)

This can be installed using composer for example, _(*3)

composer require exussum12/trip-advisor

Then the most simple method of getting the reviews is as follows, _(*4)

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

The API is paged at a maximum of 1000 reviews per page, This is all handled transparently and will page internally only requesting new data when it is required., _(*5)

You can set the page size by doing $reviews->limit(50); This will request smaller chucks. If you only want a certain size of data use $reviews->get()->getArray() which will only send one request., _(*6)

If you are trying to update existing data, use a date range, eg $reviews->since(new DateTime('2017-01-01')), _(*7)

This will only return the newer reviews., _(*8)

Options

All options can be chained, together for example, _(*9)

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

Exceptions

A few things can go wrong in this process, The exceptions are named as well as I can think of, All exceptions extend from exussum12\TripAdvisor\Exceptions\BaseException., _(*10)

The reviews which come back are immutable, So trying to write to any review will throw an exception (ImmutableObjectException), _(*11)