README

TMDB API v3 PHP 库 - 是 themoviedb.org 的 API 版本 3 的封装。

使用此库可能需要查看此项目的完整 文档。

@package TMDB-V3-PHP-API
@author Pixelead0 同样在 Github
@author Alvaro Octal 同样在 Github
@author Deso85 同样在 Github
@date 02/04/2016
@version 0.5

致谢

从由 Jonas De Smet 创建的类似 项目 衍生而来

变更日志

• [18/06/2017] v0.6

  • 实现了 multiSearch 函数
  • 添加了 multiSearch 的示例
  • 修复了示例

• [02/04/2016] v0.5

  • 创建了一个配置类来加载外部配置
  • 更新了函数列表
  • 将一些函数更改为使用配置对象
  • 更改了项目的包结构

• [01/04/2016] v0.4

  • 添加了配置文件
  • 对使用配置文件的代码进行了一些修改
  • 对注释中的某些内容进行了正式修正
  • (希望) 修正了版本号

• [17/01/2015] v0.3 - 升级者

  • 由 /Alvaroctal/TMDB-PHP-API 升级。
  • 添加了一些修改和专用类。

• [07/11/2012] v0.2

  • 修复了问题 #2 (在类 php 文件中创建的对象)
  • 添加了 latestMovie、nowPlayingMovies 函数（感谢 steffmeister）

• [12/02/2012] v0.1

  • 这是类的第一个版本，没有内联文档或测试
  • 从 glamorous/TMDb-PHP-API 衍生而来

要求

• PHP 5.2.x 或更高版本
• cURL
• TMDB API 密钥

如何使用

查看示例

初始化类

如果您有 $conf 数组

<?php
	include('tmdb-api.php');
	
	// if you have a $conf array - (See LIB_ROOT/configuration/default.php as an example)
	$tmdb = new TMDB($conf);
	
?>

如果没有 $conf 数组，它将使用默认配置，但您需要有一个 API 密钥

<?php
	include('tmdb-api.php');
	
	// if you have no $conf it uses the default config
	$tmdb = new TMDB(); 
	
	//Insert your API Key of TMDB
	//Necessary if you use default conf
	$tmdb->setAPIKey('YOUR_API_KEY');
	
?>

电影

搜索电影

<?php
	//Title to search for
	$title = 'back to the future';
	$movies = $tmdb->searchMovie($title);
	// returns an array of Movie Object
	foreach($movies as $movie){
		echo $movie->getTitle() .'<br>;
	}
?>

返回一个包含 Movie 对象的数组。

获取电影

您应该查看 Movie 类 文档，并查看您可以从一个 Movie 对象中获取的所有信息。

<?php
	$idMovie = 11;
	$movie = $tmdb->getMovie($idMovie);
	// returns a Movie Object
	echo $movie->getTitle();
?>

返回一个 Movie 对象。

电视节目

搜索电视节目

<?php
	// Title to search for
	$title = 'breaking bad';
	$tvShows = $tmdb->searchTVShow($title);
    foreach($tvShows as $tvShow){
        echo $tvShow->getName() .'<br>';
	}
?>

返回一个包含 TVShow 对象的数组。

获取 TVShow

您应该查看TVShow类的文档，看看可以从TVShow对象中获取哪些信息。

<?php
	$idTVShow = 1396;
	$tvShow = $tmdb->getTVShow($idTVShow);
	// returns a TVShow Object
	echo $tvShow->getName();
?>

返回一个TVShow对象。

获取电视剧的季数

您应该查看Season类的文档，看看可以从Season对象中获取哪些信息。

<?php
	$idTVShow = 1396;
	$numSeason = 2;
	$season = $tmdb->getSeason($idTVShow, $numSeason);
	// returns a Season Object
	echo $season->getName();
?>

返回一个Season对象。

获取电视剧的剧集

您应该查看Episode类的文档，看看可以从Episode对象中获取哪些信息。

<?php
	$idTVShow = 1396;
	$numSeason = 2;
	$numEpisode = 8;
	$episode = $tmdb->getEpisode($idTVShow, $numSeason, $numEpisode);
	// returns a Episode Object
	echo $episode->getName();
?>

返回一个Episode对象。

人物

搜索人物

<?php
	// Name to search for
	$name = 'Johnny';
	$persons = $tmdb->searchPerson($name);
    foreach($persons as $person){
        echo $person->getName() .'<br>';
    }
?>

返回一个包含Person对象的数组。

获取人物

您应该查看Person类的文档，看看可以从Person对象中获取哪些信息。

<?php
	$idPerson = 85;
	$person = $tmdb->getPerson($idPerson);
	// returns a Person Object
	echo $person->getName();
?>

返回一个Person对象。

获取人物的角色

您应该查看Role类的文档，看看可以从Role对象中获取哪些信息。

<?php
	$movieRoles = $person->getMovieRoles();
	foreach($movieRoles as $movieRole){
        echo $movieRole->getCharacter() .' in '. $movieRole->getMovieTitle() .'<br>';
    }
?>

返回一个包含MovieRole对象的数组。

<?php
	$tvShowRoles = $person->getTVShow();
	foreach($tvShowRoles as $tvShowRole){
        echo $tvShowRole->getCharacter() .' in '. $tvShowRole->getMovieName() .'<br>';
    }
?>

返回一个包含TVShowRole对象的数组。

收藏夹

搜索收藏夹

<?php
	// Name to search for
	$name = 'the hobbit';
	$collections = $tmdb->searchCollection($name);
	foreach($collections as $collection){
		echo $collection->getName() .'<br>';
	}
?>

返回一个包含Collection对象的数组。

获取收藏夹

您应该查看Collection类的文档，看看可以从Collection对象中获取哪些信息。

<?php
	$idCollection = 121938;
	$collection = $tmdb->getCollection($idCollection);
	// returns a Collection Object
	echo $collection->getName();
?>

返回一个Collection对象。

公司

搜索公司

<?php
	// Name to search for
	$name = 'Sony';
	$companies = $tmdb->searchCompany($name);
	foreach($companies as $company){
		echo $company->getName() .'<br>';
	}
?>

返回一个包含Company对象的数组。

获取公司

您应该查看Company类的文档，看看可以从Company对象中获取哪些信息。

<?php
	$idCompany = 34;
	$company = $tmdb->getCompany($idCompany);
	// returns a Company Object
	echo $company->getName();
?>

返回一个Company对象。

问题/错误

预期会有错误，这仍在开发中，您可以报告它们。

待办事项列表

• 空的 :D，您可以提议新的功能。