123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956 |
- <?php
- /**
- * TMDb PHP API class - API 'themoviedb.org'
- * API Documentation: http://help.themoviedb.org/kb/api/
- * Documentation and usage in README file
- *
- * @author Jonas De Smet - Glamorous
- * @since 09.11.2009
- * @date 16.11.2012
- * @copyright Jonas De Smet - Glamorous
- * @version 1.5.1
- * @license BSD http://www.opensource.org/licenses/bsd-license.php
- */
- class TMDb
- {
- const POST = 'post';
- const GET = 'get';
- const HEAD = 'head';
- const IMAGE_BACKDROP = 'backdrop';
- const IMAGE_POSTER = 'poster';
- const IMAGE_PROFILE = 'profile';
- const API_VERSION = '3';
- const API_URL = 'api.themoviedb.org';
- const API_SCHEME = 'http://';
- const API_SCHEME_SSL = 'https://';
- const VERSION = '1.5.0';
- /**
- * The API-key
- *
- * @var string
- */
- protected $_apikey;
- /**
- * The default language
- *
- * @var string
- */
- protected $_lang;
- /**
- * The TMDb-config
- *
- * @var object
- */
- protected $_config;
- /**
- * Stored Session Id
- *
- * @var string
- */
- protected $_session_id;
- /**
- * API Scheme
- *
- * @var string
- */
- protected $_apischeme;
- /**
- * Default constructor
- *
- * @param string $apikey API-key recieved from TMDb
- * @param string $defaultLang Default language (ISO 3166-1)
- * @param boolean $config Load the TMDb-config
- * @return void
- */
- public function __construct($apikey, $default_lang = 'en', $config = FALSE, $scheme = TMDb::API_SCHEME)
- {
- $this->_apikey = (string) $apikey;
- $this->_apischeme = ($scheme == TMDb::API_SCHEME) ? TMDb::API_SCHEME : TMDb::API_SCHEME_SSL;
- $this->setLang($default_lang);
- if($config === TRUE)
- {
- $this->getConfiguration();
- }
- }
- /**
- * Search a movie by querystring
- *
- * @param string $text Query to search after in the TMDb database
- * @param int $page Number of the page with results (default first page)
- * @param bool $adult Whether of not to include adult movies in the results (default FALSE)
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function searchMovie($query, $page = 1, $adult = FALSE, $year = NULL, $lang = NULL)
- {
- $params = array(
- 'query' => $query,
- 'page' => (int) $page,
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- 'include_adult' => (bool) $adult,
- 'year' => $year,
- );
- return $this->_makeCall('search/movie', $params);
- }
- /**
- * Search a person by querystring
- *
- * @param string $text Query to search after in the TMDb database
- * @param int $page Number of the page with results (default first page)
- * @param bool $adult Whether of not to include adult movies in the results (default FALSE)
- * @return TMDb result array
- */
- public function searchPerson($query, $page = 1, $adult = FALSE)
- {
- $params = array(
- 'query' => $query,
- 'page' => (int) $page,
- 'include_adult' => (bool) $adult,
- );
- return $this->_makeCall('search/person', $params);
- }
- /**
- * Search a company by querystring
- *
- * @param string $text Query to search after in the TMDb database
- * @param int $page Number of the page with results (default first page)
- * @return TMDb result array
- */
- public function searchCompany($query, $page = 1)
- {
- $params = array(
- 'query' => $query,
- 'page' => $page,
- );
- return $this->_makeCall('search/company', $params);
- }
- /**
- * Retrieve information about a collection
- *
- * @param int $id Id from a collection (retrieved with getMovie)
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getCollection($id, $lang = NULL)
- {
- $params = array(
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('collection/'.$id, $params);
- }
- /**
- * Retrieve all basic information for a particular movie
- *
- * @param mixed $id TMDb-id or IMDB-id
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getMovie($id, $lang = NULL)
- {
- $params = array(
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('movie/'.$id, $params);
- }
- /**
- * Retrieve alternative titles for a particular movie
- *
- * @param mixed $id TMDb-id or IMDB-id
- * @params string $country Only include titles for a particular country (ISO 3166-1)
- * @return TMDb result array
- */
- public function getMovieTitles($id, $country = NULL)
- {
- $params = array(
- 'country' => $country,
- );
- return $this->_makeCall('movie/'.$id.'/alternative_titles', $params);
- }
- /**
- * Retrieve all of the movie cast information for a particular movie
- *
- * @param mixed $id TMDb-id or IMDB-id
- * @return TMDb result array
- */
- public function getMovieCast($id)
- {
- return $this->_makeCall('movie/'.$id.'/casts');
- }
- /**
- * Retrieve all of the keywords for a particular movie
- *
- * @param mixed $id TMDb-id or IMDB-id
- * @return TMDb result array
- */
- public function getMovieKeywords($id)
- {
- return $this->_makeCall('movie/'.$id.'/keywords');
- }
- /**
- * Retrieve all the release and certification data for a particular movie
- *
- * @param mixed $id TMDb-id or IMDB-id
- * @return TMDb result array
- */
- public function getMovieReleases($id)
- {
- return $this->_makeCall('movie/'.$id.'/releases');
- }
- /**
- * Retrieve available translations for a particular movie
- *
- * @param mixed $id TMDb-id or IMDB-id
- * @return TMDb result array
- */
- public function getMovieTranslations($id)
- {
- return $this->_makeCall('movie/'.$id.'/translations');
- }
- /**
- * Retrieve available trailers for a particular movie
- *
- * @param mixed $id TMDb-id or IMDB-id
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getMovieTrailers($id, $lang = NULL)
- {
- $params = array(
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('movie/'.$id.'/trailers', $params);
- }
- /**
- * Retrieve all images for a particular movie
- *
- * @param mixed $id TMDb-id or IMDB-id
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getMovieImages($id, $lang = NULL)
- {
- $params = array(
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('movie/'.$id.'/images', $params);
- }
- /**
- * Retrieve similar movies for a particular movie
- *
- * @param mixed $id TMDb-id or IMDB-id
- * @param int $page Number of the page with results (default first page)
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getSimilarMovies($id, $page = 1, $lang = NULL)
- {
- $params = array(
- 'page' => (int) $page,
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('movie/'.$id.'/similar_movies', $params);
- }
- /**
- * Retrieve newest movie added to TMDb
- *
- * @return TMDb result array
- */
- public function getLatestMovie()
- {
- return $this->_makeCall('movie/latest');
- }
- /**
- * Retrieve movies arriving to theatres within the next few weeks
- *
- * @param int $page Number of the page with results (default first page)
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getUpcomingMovies($page = 1, $lang = NULL)
- {
- $params = array(
- 'page' => (int) $page,
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('movie/upcoming', $params);
- }
- /**
- * Retrieve movies currently in theatres
- *
- * @param int $page Number of the page with results (default first page)
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getNowPlayingMovies($page = 1, $lang = NULL)
- {
- $params = array(
- 'page' => (int) $page,
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('movie/now_playing', $params);
- }
- /**
- * Retrieve popular movies (list is updated daily)
- *
- * @param int $page Number of the page with results (default first page)
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getPopularMovies($page = 1, $lang = NULL)
- {
- $params = array(
- 'page' => (int) $page,
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('movie/popular', $params);
- }
- /**
- * Retrieve top-rated movies
- *
- * @param int $page Number of the page with results (default first page)
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getTopRatedMovies($page = 1, $lang = NULL)
- {
- $params = array(
- 'page' => (int) $page,
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('movie/top_rated', $params);
- }
- /**
- * Retrieve changes for a particular movie
- *
- * @param mixed $id TMDb-id or IMDB-id
- * @return TMDb result array
- */
- public function getMovieChanges($id)
- {
- return $this->_makeCall('movie/'.$id.'/changes');
- }
- /**
- * Retrieve all id's from changed movies
- *
- * @param int $page Number of the page with results (default first page)
- * @param string $start_date String start date as YYYY-MM-DD
- * @param string $end_date String end date as YYYY-MM-DD (not inclusive)
- * @return TMDb result array
- */
- public function getChangedMovies($page = 1, $start_date = NULL, $end_date = NULL)
- {
- $params = array(
- 'page' => (int) $page,
- 'start_date' => $start_date,
- 'end_date' => $end_date,
- );
- return $this->_makeCall('movie/changes', $params);
- }
- /**
- * Retrieve all basic information for a particular person
- *
- * @param int $id TMDb person-id
- * @return TMDb result array
- */
- public function getPerson($id)
- {
- return $this->_makeCall('person/'.$id);
- }
- /**
- * Retrieve all cast and crew information for a particular person
- *
- * @param int $id TMDb person-id
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getPersonCredits($id, $lang = NULL)
- {
- $params = array(
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('person/'.$id.'/credits', $params);
- }
- /**
- * Retrieve all images for a particular person
- *
- * @param mixed $id TMDb person-id
- * @return TMDb result array
- */
- public function getPersonImages($id)
- {
- return $this->_makeCall('person/'.$id.'/images');
- }
- /**
- * Retrieve changes for a particular person
- *
- * @param mixed $id TMDb person-id
- * @return TMDb result array
- */
- public function getPersonChanges($id)
- {
- return $this->_makeCall('person/'.$id.'/changes');
- }
- /**
- * Retrieve all id's from changed persons
- *
- * @param int $page Number of the page with results (default first page)
- * @param string $start_date String start date as YYYY-MM-DD
- * @param string $end_date String end date as YYYY-MM-DD (not inclusive)
- * @return TMDb result array
- */
- public function getChangedPersons($page = 1, $start_date = NULL, $end_date = NULL)
- {
- $params = array(
- 'page' => (int) $page,
- 'start_date' => $start_date,
- 'start_date' => $end_date,
- );
- return $this->_makeCall('person/changes', $params);
- }
- /**
- * Retrieve all basic information for a particular production company
- *
- * @param int $id TMDb company-id
- * @return TMDb result array
- */
- public function getCompany($id)
- {
- return $this->_makeCall('company/'.$id);
- }
- /**
- * Retrieve movies for a particular production company
- *
- * @param int $id TMDb company-id
- * @param int $page Number of the page with results (default first page)
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getMoviesByCompany($id, $page = 1, $lang = NULL)
- {
- $params = array(
- 'page' => (int) $page,
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('company/'.$id.'/movies', $params);
- }
- /**
- * Retrieve a list of genres used on TMDb
- *
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getGenres($lang = NULL)
- {
- $params = array(
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('genre/list', $params);
- }
- /**
- * Retrieve movies for a particular genre
- *
- * @param int $id TMDb genre-id
- * @param int $page Number of the page with results (default first page)
- * @param mixed $lang Filter the result with a language (ISO 3166-1) other then default, use FALSE to retrieve results from all languages
- * @return TMDb result array
- */
- public function getMoviesByGenre($id, $page = 1, $lang = NULL)
- {
- $params = array(
- 'page' => (int) $page,
- 'language' => ($lang !== NULL) ? $lang : $this->getLang(),
- );
- return $this->_makeCall('genre/'.$id.'/movies', $params);
- }
- /**
- * Authentication: retrieve authentication token
- * More information about the authentication process: http://help.themoviedb.org/kb/api/user-authentication
- *
- * @return TMDb result array
- */
- public function getAuthToken()
- {
- $result = $this->_makeCall('authentication/token/new');
- if( ! isset($result['request_token']))
- {
- if($this->getDebugMode())
- {
- throw new TMDbException('No valid request token from TMDb');
- }
- else
- {
- return FALSE;
- }
- }
- return $result;
- }
- /**
- * Authentication: retrieve authentication session and set it to the class
- * More information about the authentication process: http://help.themoviedb.org/kb/api/user-authentication
- *
- * @param string $token
- * @return TMDb result array
- */
- public function getAuthSession($token)
- {
- $params = array(
- 'request_token' => $token,
- );
- $result = $this->_makeCall('authentication/session/new', $params);
- if(isset($result['session_id']))
- {
- $this->setAuthSession($result['session_id']);
- }
- return $result;
- }
- /**
- * Authentication: set retrieved session id in the class for authenticated requests
- * More information about the authentication process: http://help.themoviedb.org/kb/api/user-authentication
- *
- * @param string $session_id
- */
- public function setAuthSession($session_id)
- {
- $this->_session_id = $session_id;
- }
- /**
- * Retrieve basic account information
- *
- * @param string $session_id Set session_id for the account you want to retrieve information from
- * @return TMDb result array
- */
- public function getAccount($session_id = NULL)
- {
- $session_id = ($session_id === NULL) ? $this->_session_id : $session_id;
- return $this->_makeCall('account', NULL, $session_id);
- }
- /**
- * Retrieve favorite movies for a particular account
- *
- * @param int $account_id TMDb account-id
- * @param string $session_id Set session_id for the account you want to retrieve information from
- * @param int $page Number of the page with results (default first page)
- * @param mixed $lang Get result in other language then default for this user account (ISO 3166-1)
- * @return TMDb result array
- */
- public function getAccountFavoriteMovies($account_id, $session_id = NULL, $page = 1, $lang = FALSE)
- {
- $session_id = ($session_id === NULL) ? $this->_session_id : $session_id;
- $params = array(
- 'page' => (int) $page,
- 'language' => ($lang !== NULL) ? $lang : '',
- );
- return $this->_makeCall('account/'.$account_id.'/favorite_movies', $params, $session_id);
- }
- /**
- * Retrieve rated movies for a particular account
- *
- * @param int $account_id TMDb account-id
- * @param string $session_id Set session_id for the account you want to retrieve information from
- * @param int $page Number of the page with results (default first page)
- * @param mixed $lang Get result in other language then default for this user account (ISO 3166-1)
- * @return TMDb result array
- */
- public function getAccountRatedMovies($account_id, $session_id = NULL, $page = 1, $lang = FALSE)
- {
- $session_id = ($session_id === NULL) ? $this->_session_id : $session_id;
- $params = array(
- 'page' => (int) $page,
- 'language' => ($lang !== NULL) ? $lang : '',
- );
- return $this->_makeCall('account/'.$account_id.'/rated_movies', $params, $session_id);
- }
- /**
- * Retrieve movies that have been marked in a particular account watchlist
- *
- * @param int $account_id TMDb account-id
- * @param string $session_id Set session_id for the account you want to retrieve information from
- * @param int $page Number of the page with results (default first page)
- * @param mixed $lang Get result in other language then default for this user account (ISO 3166-1)
- * @return TMDb result array
- */
- public function getAccountWatchlistMovies($account_id, $session_id = NULL, $page = 1, $lang = FALSE)
- {
- $session_id = ($session_id === NULL) ? $this->_session_id : $session_id;
- $params = array(
- 'page' => (int) $page,
- 'language' => ($lang !== NULL) ? $lang : '',
- );
- return $this->_makeCall('account/'.$account_id.'/movie_watchlist', $params, $session_id);
- }
- /**
- * Add a movie to the account favorite movies
- *
- * @param int $account_id TMDb account-id
- * @param string $session_id Set session_id for the account you want to retrieve information from
- * @param int $movie_id TMDb movie-id
- * @param bool $favorite Add to favorites or remove from favorites (default TRUE)
- * @return TMDb result array
- */
- public function addFavoriteMovie($account_id, $session_id = NULL, $movie_id = 0, $favorite = TRUE)
- {
- $session_id = ($session_id === NULL) ? $this->_session_id : $session_id;
- $params = array(
- 'movie_id' => (int) $movie_id,
- 'favorite' => (bool) $favorite,
- );
- return $this->_makeCall('account/'.$account_id.'/favorite', $params, $session_id, TMDb::POST);
- }
- /**
- * Add a movie to the account watchlist
- *
- * @param int $account_id TMDb account-id
- * @param string $session_id Set session_id for the account you want to retrieve information from
- * @param int $movie_id TMDb movie-id
- * @param bool $watchlist Add to watchlist or remove from watchlist (default TRUE)
- * @return TMDb result array
- */
- public function addMovieToWatchlist($account_id, $session_id = NULL, $movie_id = 0, $watchlist = TRUE)
- {
- $session_id = ($session_id === NULL) ? $this->_session_id : $session_id;
- $params = array(
- 'movie_id' => (int) $movie_id,
- 'movie_watchlist' => (bool) $watchlist,
- );
- return $this->_makeCall('account/'.$account_id.'/movie_watchlist', $params, $session_id, TMDb::POST);
- }
- /**
- * Add a rating to a movie
- *
- * @param string $session_id Set session_id for the account you want to retrieve information from
- * @param int $movie_id TMDb movie-id
- * @param float $value Value between 1 and 10
- * @return TMDb result array
- */
- public function addMovieRating($session_id = NULL, $movie_id = 0, $value = 0)
- {
- $session_id = ($session_id === NULL) ? $this->_session_id : $session_id;
- $params = array(
- 'value' => is_numeric($value) ? floatval($value) : 0,
- );
- return $this->_makeCall('movie/'.$movie_id.'/rating', $params, $session_id, TMDb::POST);
- }
- /**
- * Get configuration from TMDb
- *
- * @return TMDb result array
- */
- public function getConfiguration()
- {
- $config = $this->_makeCall('configuration');
- if( ! empty($config))
- {
- $this->setConfig($config);
- }
- return $config;
- }
- /**
- * Get Image URL
- *
- * @param string $filepath Filepath to image
- * @param const $imagetype Image type: TMDb::IMAGE_BACKDROP, TMDb::IMAGE_POSTER, TMDb::IMAGE_PROFILE
- * @param string $size Valid size for the image
- * @return string
- */
- public function getImageUrl($filepath, $imagetype, $size)
- {
- $config = $this->getConfig();
- if(isset($config['images']))
- {
- $base_url = $config['images']['base_url'];
- $available_sizes = $this->getAvailableImageSizes($imagetype);
- if(in_array($size, $available_sizes))
- {
- return $base_url.$size.$filepath;
- }
- else
- {
- throw new TMDbException('The size "'.$size.'" is not supported by TMDb');
- }
- }
- else
- {
- throw new TMDbException('No configuration available for image URL generation');
- }
- }
- /**
- * Get available image sizes for a particular image type
- *
- * @param const $imagetype Image type: TMDb::IMAGE_BACKDROP, TMDb::IMAGE_POSTER, TMDb::IMAGE_PROFILE
- * @return array
- */
- public function getAvailableImageSizes($imagetype)
- {
- $config = $this->getConfig();
- if(isset($config['images'][$imagetype.'_sizes']))
- {
- return $config['images'][$imagetype.'_sizes'];
- }
- else
- {
- throw new TMDbException('No configuration available to retrieve available image sizes');
- }
- }
- /**
- * Get ETag to keep track of state of the content
- *
- * @param string $uri Use an URI to know the version of it. For example: 'movie/550'
- * @return string
- */
- public function getVersion($uri)
- {
- $headers = $this->_makeCall($uri, NULL, NULL, TMDb::HEAD);
- return isset($headers['Etag']) ? $headers['Etag'] : '';
- }
- /**
- * Makes the call to the API
- *
- * @param string $function API specific function name for in the URL
- * @param array $params Unencoded parameters for in the URL
- * @param string $session_id Session_id for authentication to the API for specific API methods
- * @param const $method TMDb::GET or TMDb:POST (default TMDb::GET)
- * @return TMDb result array
- */
- private function _makeCall($function, $params = NULL, $session_id = NULL, $method = TMDb::GET)
- {
- $params = ( ! is_array($params)) ? array() : $params;
- $auth_array = array('api_key' => $this->_apikey);
- if($session_id !== NULL)
- {
- $auth_array['session_id'] = $session_id;
- }
- $url = $this->_apischeme.TMDb::API_URL.'/'.TMDb::API_VERSION.'/'.$function.'?'.http_build_query($auth_array, '', '&');
- if($method === TMDb::GET)
- {
- if(isset($params['language']) AND $params['language'] === FALSE)
- {
- unset($params['language']);
- }
- $url .= ( ! empty($params)) ? '&'.http_build_query($params, '', '&') : '';
- }
- $results = '{}';
- if (extension_loaded('curl'))
- {
- $headers = array(
- 'Accept: application/json',
- );
- $ch = curl_init();
- if($method == TMDB::POST)
- {
- $json_string = json_encode($params);
- curl_setopt($ch,CURLOPT_POST, 1);
- curl_setopt($ch,CURLOPT_POSTFIELDS, $json_string);
- $headers[] = 'Content-Type: application/json';
- $headers[] = 'Content-Length: '.strlen($json_string);
- }
- elseif($method == TMDb::HEAD)
- {
- curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'HEAD');
- curl_setopt($ch, CURLOPT_NOBODY, 1);
- }
- curl_setopt($ch, CURLOPT_URL, $url);
- curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
- curl_setopt($ch, CURLOPT_HEADER, 1);
- curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
- $response = curl_exec($ch);
- $header_size = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
- $header = substr($response, 0, $header_size);
- $body = substr($response, $header_size);
- $error_number = curl_errno($ch);
- $error_message = curl_error($ch);
- if($error_number > 0)
- {
- throw new TMDbException('Method failed: '.$function.' - '.$error_message);
- }
- curl_close($ch);
- }
- else
- {
- throw new TMDbException('CURL-extension not loaded');
- }
- $results = json_decode($body, TRUE);
- if(strpos($function, 'authentication/token/new') !== FALSE)
- {
- $parsed_headers = $this->_http_parse_headers($header);
- $results['Authentication-Callback'] = $parsed_headers['Authentication-Callback'];
- }
- if($results !== NULL)
- {
- return $results;
- }
- elseif($method == TMDb::HEAD)
- {
- return $this->_http_parse_headers($header);
- }
- else
- {
- throw new TMDbException('Server error on "'.$url.'": '.$response);
- }
- }
- /**
- * Setter for the default language
- *
- * @param string $lang (ISO 3166-1)
- * @return void
- */
- public function setLang($lang)
- {
- $this->_lang = $lang;
- }
- /**
- * Setter for the TMDB-config
- *
- * $param array $config
- * @return void
- */
- public function setConfig($config)
- {
- $this->_config = $config;
- }
- /**
- * Getter for the default language
- *
- * @return string
- */
- public function getLang()
- {
- return $this->_lang;
- }
- /**
- * Getter for the TMDB-config
- *
- * @return array
- */
- public function getConfig()
- {
- if(empty($this->_config))
- {
- $this->_config = $this->getConfiguration();
- }
- return $this->_config;
- }
- /*
- * Internal function to parse HTTP headers because of lack of PECL extension installed by many
- *
- * @param string $header
- * @return array
- */
- protected function _http_parse_headers($header)
- {
- $return = array();
- $fields = explode("\r\n", preg_replace('/\x0D\x0A[\x09\x20]+/', ' ', $header));
- foreach($fields as $field)
- {
- if(preg_match('/([^:]+): (.+)/m', $field, $match))
- {
- $match[1] = preg_replace('/(?<=^|[\x09\x20\x2D])./e', 'strtoupper("\0")', strtolower(trim($match[1])));
- if( isset($return[$match[1]]) )
- {
- $return[$match[1]] = array($return[$match[1]], $match[2]);
- }
- else
- {
- $return[$match[1]] = trim($match[2]);
- }
- }
- }
- return $return;
- }
- }
- /**
- * TMDb Exception class
- *
- * @author Jonas De Smet - Glamorous
- */
- class TMDbException extends Exception{}
- ?>
|