* @copyright 2012 pixelead0
* @date 2012-02-12
* @link http://www.github.com/pixelead
* @version 0.0.2
* @license BSD http://www.opensource.org/licenses/bsd-license.php
*
*
* Portions of this file are based on pieces of TMDb PHP API class - API 'themoviedb.org'
* @Copyright Jonas De Smet - Glamorous | https://github.com/glamorous/TMDb-PHP-API
* Licensed under BSD (http://www.opensource.org/licenses/bsd-license.php)
* @date 10.12.2010
* @version 0.9.10
* @author Jonas De Smet - Glamorous
* @link {https://github.com/glamorous/TMDb-PHP-API}
*
* Added config file + some formal corrections inside comments + some code changes to use config + (hopefully) corrected versioning
* @Copyright Deso85 | https://github.com/deso85/tmdb_v3-PHP-API-
* Licensed under BSD (http://www.opensource.org/licenses/bsd-license.php)
* @date 01.04.2016
* @version 0.4
* @author Deso85
* @link {https://github.com/deso85/tmdb_v3-PHP-API-}
*
* Function List
* public function __construct($apikey,$lang,$adult,$debug)
* public function setLang($lang="en")
* public function getLang()
* public function setAdult($adult=false);
* public function getAdult();
* public function setDebug($debug=false);
* public function getDebug();
* public function setImageURL($config)
* public function getImageURL($size="original")
* public function movieTitles($idMovie)
* public function movieTrans($idMovie)
* public function movieTrailer($idMovie,$source="")
* public function movieDetail($idMovie)
* public function moviePoster($idMovie)
* public function movieCast($idMovie)
* public function movieInfo($idMovie,$option="",$print=false)
* public function searchMovie($movieTitle)
* public function getAPIConfig()
* public function latestMovie()
* public function nowPlayingMovies($page=1)
*
* private function _getDataArray($action,$text,$lang="")
* private function setApikey($apikey)
* private function getApikey()
*
*
* URL LIST:
* configuration http://api.themoviedb.org/3/configuration
* Image http://cf2.imgobject.com/t/p/original/IMAGEN.jpg #### echar un ojo ####
* Search Movie http://api.themoviedb.org/3/search/movie
* Search Person http://api.themoviedb.org/3/search/person
* Movie Info http://api.themoviedb.org/3/movie/11
* Casts http://api.themoviedb.org/3/movie/11/casts
* Posters http://api.themoviedb.org/3/movie/11/images
* Trailers http://api.themoviedb.org/3/movie/11/trailers
* translations http://api.themoviedb.org/3/movie/11/translations
* Alternative titles http://api.themoviedb.org/3/movie/11/alternative_titles
*
* Collection Info http://api.themoviedb.org/3/collection/11
* Person images http://api.themoviedb.org/3/person/287/images
*/
class TMDB {
public const _API_URL_ = 'http://api.themoviedb.org/3/';
public const VERSION = '0.0.3.0';
private $_config;
private $_apikey;
private $_lang;
private $_adult;
private $_apiconfiguration;
private $_debug;
/**
* Construct Class
* If any param is not specified, will load from config.
*
* @param string $apikey The API key token
* @param string $lang The language to work with
* @param boolean $adult The flag for adult content
* @param boolean $debug The flag for debug output
*/
public function __construct($apikey = null, $lang = null, $adult = null, $debug = null) {
require_once 'TMDb/config/config.php';
$this->setConfig($cnf);
$this->setApikey(isset($apikey) ? $apikey : $cnf['apikey']);
$this->setLang(isset($lang) ? $lang : $cnf['lang']);
$this->setAdult(isset($adult) ? $adult : $cnf['adult']);
$this->setDebug(isset($debug) ? $debug : $cnf['debug']);
if (!$this->_loadConfig()) {
echo _('Unable to read configuration, verify that the API key is valid');
exit();
}
}
/**
* Set configuration parameters
*
* @param array $config
*/
private function setConfig($config) {
$this->_config = $config;
}
/**
* Get the config parameters
*
* @return array $config
*/
private function getConfig() {
return $this->_config;
}
/**
* Set the API key
*
* @param string $apikey
* @return void
*/
private function setApikey($apikey) {
$this->_apikey = (string) $apikey;
}
/**
* Get the API key
*
* @return string
*/
private function getApikey() {
return $this->_apikey;
}
/**
* Set the language
* By default english
*
* @param string $lang
*/
public function setLang($lang = 'en') {
$this->_lang = (string) $lang;
}
/**
* Get the language
*
* @return string
*/
public function getLang() {
return $this->_lang;
}
/**
* Set adult content flag
* By default false
*
* @param boolean $adult
*/
public function setAdult($adult = false) {
$this->_adult = $adult;
}
/**
* Get the adult content flag
*
* @return string
*/
public function getAdult() {
return $this->_adult ? 'true' : 'false';
}
/**
* Set debug mode
* By default false
*
* @param boolean $debug
*/
public function setDebug($debug = false) {
$this->_debug = $debug;
}
/**
* Get debug status
*
* @return boolean
*/
public function getDebug() {
return $this->_debug;
}
/**
* Loads the configuration of the API
*
* @return boolean
*/
private function _loadConfig() {
$this->_apiconfiguration = new APIConfiguration($this->_call('configuration'));
return !empty($this->_apiconfiguration);
}
/**
* Get Configuration of the API (Revisar)
*
* @return Configuration
*/
public function getAPIConfig() {
return $this->_apiconfiguration;
}
/**
* Get the URL images
* You can specify the width, by default original
*
* @param String $size A String like 'w185' where you specify the image width
* @return string
*/
public function getImageURL($size = 'original') {
return $this->_apiconfiguration->getImageBaseURL() . $size;
}
/**
* Discover Movies
* @add by tnsws
*
* @return Movie[]
*/
public function getDiscoverMovies($page = 1) {
$movies = array();
$result = $this->_call('discover/movie', '&page=' . $page);
foreach ($result['results'] as $data) {
$movies[] = new Movie($data);
}
return $movies;
}
/**
* Discover TVShows
* @add by tnsws
*
* @return TVShow[]
*/
public function getDiscoverTVShows($page = 1) {
$tvShows = array();
$result = $this->_call('discover/tv', '&page=' . $page);
foreach ($result['results'] as $data) {
$tvShows[] = new TVShow($data);
}
return $tvShows;
}
/**
* Get latest Movie
* @add by tnsws
*
* @return Movie
*/
public function getDiscoverMovie($page = 1) {
$movies = array();
$result = $this->_call('discover/movie', 'page=' . $page);
foreach ($result['results'] as $data) {
$movies[] = new Movie($data);
}
return $movies;
}
/**
* Get latest Movie
*
* @return Movie
*/
public function getLatestMovie() {
return new Movie($this->_call('movie/latest'));
}
/**
* Get Now Playing Movies
*
* @param integer $page
* @return Movie[]
*/
public function getNowPlayingMovies($page = 1) {
$movies = array();
$result = $this->_call('movie/now_playing', '&page=' . $page);
foreach ($result['results'] as $data) {
$movies[] = new Movie($data);
}
return $movies;
}
/**
* Get Popular Movies
*
* @param integer $page
* @return Movie[]
*/
public function getPopularMovies($page = 1) {
$movies = array();
$result = $this->_call('movie/popular', '&page=' . $page);
foreach ($result['results'] as $data) {
$movies[] = new Movie($data);
}
return $movies;
}
/**
* Get Top Rated Movies
* @add by tnsws
*
* @param integer $page
* @return Movie[]
*/
public function getTopRatedMovies($page = 1) {
$movies = array();
$result = $this->_call('movie/top_rated', '&page=' . $page);
foreach ($result['results'] as $data) {
$movies[] = new Movie($data);
}
return $movies;
}
/**
* Get Upcoming Movies
* @add by tnsws
*
* @param integer $page
* @return Movie[]
*/
public function getUpcomingMovies($page = 1) {
$movies = array();
$result = $this->_call('movie/upcoming', '&page=' . $page);
foreach ($result['results'] as $data) {
$movies[] = new Movie($data);
}
return $movies;
}
public function getSimilarMovies($id, $page = 1) {
$movies = array();
$result = $this->_call('movie/' . $id . '/similar', '&page=' . $page);
foreach ($result['results'] as $data) {
$movies[] = new Movie($data);
}
return $movies;
}
/**
* Get latest TVShow
*
* @return TVShow
*/
public function getLatestTVShow() {
return new TVShow($this->_call('tv/latest'));
}
/**
* Get On The Air TVShows
*
* @param integer $page
* @return TVShow[]
*/
public function getOnTheAirTVShows($page = 1) {
$tvShows = array();
$result = $this->_call('tv/on_the_air', '&page=' . $page);
foreach ($result['results'] as $data) {
$tvShows[] = new TVShow($data);
}
return $tvShows;
}
public function getSimilarSeries($id, $page = 1) {
$result = $this->_call('tv/' . $id . '/similar', '&page=' . $page);
return $result['results'];
}
/**
* Get Airing Today TVShows
*
* @param integer $page
* @param string $timezone
* @return TVShow[]
*/
public function getAiringTodayTVShows($page = 1, $timeZone = 'Europe/Madrid') {
$tvShows = array();
$result = $this->_call('tv/airing_today', '&page=' . $page);
foreach ($result['results'] as $data) {
$tvShows[] = new TVShow($data);
}
return $tvShows;
}
/**
* Get Top Rated TVShows
*
* @param integer $page
* @return TVShow[]
*/
public function getTopRatedTVShows($page = 1) {
$tvShows = array();
$result = $this->_call('tv/top_rated', '&page=' . $page);
foreach ($result['results'] as $data) {
$tvShows[] = new TVShow($data);
}
return $tvShows;
}
/**
* Get Popular TVShows
*
* @param integer $page
* @return TVShow[]
*/
public function getPopularTVShows($page = 1) {
$tvShows = array();
$result = $this->_call('tv/popular', '&page=' . $page);
foreach ($result['results'] as $data) {
$tvShows[] = new TVShow($data);
}
return $tvShows;
}
/**
* Get latest Person
*
* @return Person
*/
public function getLatestPerson() {
return new Person($this->_call('person/latest'));
}
/**
* Get Popular Persons
*
* @return Person[]
*/
public function getPopularPersons($page = 1) {
$persons = array();
$result = $this->_call('person/popular', '&page=' . $page);
foreach ($result['results'] as $data) {
$persons[] = new Person($data);
}
return $persons;
}
/**
* Makes the call to the API and retrieves the data as a JSON
*
* @param string $action API specific function name for in the URL
* @param string $appendToResponse The extra append of the request
* @return string
*/
private function _call($action, $appendToResponse = '') {
$url = 'http://api.themoviedb.org/3/' . $action . '?api_key=' . $this->getApikey() . '&language=' . $this->getLang() . '&append_to_response=' . implode(',', (array) $appendToResponse) . '&include_adult=' . $this->getAdult();
if ($this->_debug) {
echo '
check request'; } $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_FAILONERROR, 1); $results = curl_exec($ch); curl_close($ch); return (array) json_decode($results, true); } /** * Get a Movie * * @param int $idMovie The Movie id * @param array $appendToResponse The extra append of the request * @return Movie */ public function getMovie($idMovie, $appendToResponse = null) { $appendToResponse = (isset($appendToResponse) ? $appendToResponse : $this->getConfig()['appender']['movie']['default']); return new Movie($this->_call('movie/' . $idMovie, $appendToResponse)); } public function getMovieTitles($idMovie) { return $this->_call('movie/' . $idMovie . '/alternative_titles'); } public function getSeriesTitles($idTVShow) { return $this->_call('tv/' . $idTVShow . '/alternative_titles'); } /** * Get a TVShow * * @param int $idTVShow The TVShow id * @param array $appendToResponse The extra append of the request * @return TVShow */ public function getTVShow($idTVShow, $appendToResponse = null) { $appendToResponse = (isset($appendToResponse) ? $appendToResponse : $this->getConfig()['appender']['tvshow']['default']); return new TVShow($this->_call('tv/' . $idTVShow, $appendToResponse)); } /** * Get a Season * * @param int $idTVShow The TVShow id * @param int $numSeason The Season number * @param array $appendToResponse The extra append of the request * @return Season */ public function getSeason($idTVShow, $numSeason, $appendToResponse = null) { $appendToResponse = (isset($appendToResponse) ? $appendToResponse : $this->getConfig()['appender']['season']['default']); return new Season($this->_call('tv/' . $idTVShow . '/season/' . $numSeason, $appendToResponse), $idTVShow); } /** * Get a Episode * * @param int $idTVShow The TVShow id * @param int $numSeason The Season number * @param int $numEpisode the Episode number * @param array $appendToResponse The extra append of the request * @return Episode */ public function getEpisode($idTVShow, $numSeason, $numEpisode, $appendToResponse = null) { $appendToResponse = (isset($appendToResponse) ? $appendToResponse : $this->getConfig()['appender']['episode']['default']); return new Episode($this->_call('tv/' . $idTVShow . '/season/' . $numSeason . '/episode/' . $numEpisode, $appendToResponse), $idTVShow); } /** * Get a Person * * @param int $idPerson The Person id * @param array $appendToResponse The extra append of the request * @return Person */ public function getPerson($idPerson, $appendToResponse = null) { $appendToResponse = (isset($appendToResponse) ? $appendToResponse : $this->getConfig()['appender']['person']['default']); return new Person($this->_call('person/' . $idPerson, $appendToResponse)); } /** * Get a Collection * * @param int $idCollection The Person id * @param array $appendToResponse The extra append of the request * @return Collection */ public function getCollection($idCollection, $appendToResponse = null) { $appendToResponse = (isset($appendToResponse) ? $appendToResponse : $this->getConfig()['appender']['collection']['default']); return new Collection($this->_call('collection/' . $idCollection, $appendToResponse)); } /** * Get a Company * * @param int $idCompany The Person id * @param array $appendToResponse The extra append of the request * @return Company */ public function getCompany($idCompany, $appendToResponse = null) { $appendToResponse = (isset($appendToResponse) ? $appendToResponse : $this->getConfig()['appender']['company']['default']); return new Company($this->_call('company/' . $idCompany, $appendToResponse)); } /** * Search Movie * * @param string $movieTitle The title of a Movie * @return Movie[] */ public function searchMovie($movieTitle, $rYear = null) { $movies = array(); $result = $this->_call('search/movie', '&query=' . urlencode($movieTitle) . ($rYear ? '&primary_release_year=' . intval($rYear) : '')); foreach ($result['results'] as $data) { $movies[] = new Movie($data); } return $movies; } /** * Search TVShow * * @param string $tvShowTitle The title of a TVShow * @return TVShow[] */ public function searchTVShow($tvShowTitle, $rYear = null) { $tvShows = array(); $result = $this->_call('search/tv', '&query=' . urlencode($tvShowTitle) . ($rYear ? '&first_air_date_year=' . intval($rYear) : '')); foreach ($result['results'] as $data) { $tvShows[] = new TVShow($data); } return $tvShows; } /** * Search Person * * @param string $personName The name of the Person * @return Person[] */ public function searchPerson($personName) { $persons = array(); $result = $this->_call('search/person', '&query=' . urlencode($personName)); foreach ($result['results'] as $data) { $persons[] = new Person($data); } return $persons; } /** * Search Collection * * @param string $collectionName The name of the Collection * @return Collection[] */ public function searchCollection($collectionName) { $collections = array(); $result = $this->_call('search/collection', '&query=' . urlencode($collectionName)); foreach ($result['results'] as $data) { $collections[] = new Collection($data); } return $collections; } /** * Search Company * * @param string $companyName The name of the Company * @return Company[] */ public function searchCompany($companyName) { $companies = array(); $result = $this->_call('search/company', '&query=' . urlencode($companyName)); foreach ($result['results'] as $data) { $companies[] = new Company($data); } return $companies; } /** * Find * * @param string $companyName The name of the Company * @return array */ public function find($id, $external_source = 'imdb_id') { $found = array(); $result = $this->_call('find/' . $id, '&external_source=' . urlencode($external_source)); foreach ($result['movie_results'] as $data) { $found['movies'][] = new Movie($data); } foreach ($result['person_results'] as $data) { $found['persons'][] = new Person($data); } foreach ($result['tv_results'] as $data) { $found['tvshows'][] = new TVShow($data); } foreach ($result['tv_season_results'] as $data) { $found['seasons'][] = new Season($data); } foreach ($result['tv_episode_results'] as $data) { $found['episodes'][] = new Episode($data); } return $found; } /** * Get Timezones * * @return array */ public function getTimezones() { return $this->_call('timezones/list'); } /** * Get Jobs * * @return array */ public function getJobs() { return $this->_call('job/list'); } /** * Get Movie Genres * * @return Genre[] */ public function getMovieGenres() { $genres = array(); $result = $this->_call('genre/movie/list'); foreach ($result['genres'] as $data) { $genres[] = new Genre($data); } return $genres; } /** * Get TV Genres * * @return Genre[] */ public function getTVGenres() { $genres = array(); $result = $this->_call('genre/tv/list'); foreach ($result['genres'] as $data) { $genres[] = new Genre($data); } return $genres; } /** * Get Movies by Genre * * @param integer $idGenre * @param integer $page * @return Movie[] */ public function getMoviesByGenre($idGenre, $page = 1) { $movies = array(); $result = $this->_call('genre/' . $idGenre . '/movies', '&page=' . $page); foreach ($result['results'] as $data) { $movies[] = new Movie($data); } return $movies; } } include 'TMDb/Movie.php'; include 'TMDb/TVShow.php'; include 'TMDb/Season.php'; include 'TMDb/Episode.php'; include 'TMDb/Person.php'; include 'TMDb/Role.php'; include 'TMDb/roles/MovieRole.php'; include 'TMDb/roles/TVShowRole.php'; include 'TMDb/Collection.php'; include 'TMDb/Company.php'; include 'TMDb/Genre.php'; include 'TMDb/config/APIConfiguration.php';