README

一个用于通过数据源访问TMDB API的CakePHP插件。

插件目的

该插件的目的是为任何CakePHP应用提供对TMDB API的简单访问。目前该插件仅包含TMDB数据源，但将逐步发展包括模型、控制器、视图和辅助函数。使用该插件，您将能够创建一个应用程序，该应用程序可以访问广泛的电影、演员以及TMDB API提供的所有数据。

要求

CakePHP版本2.0
TMDB API密钥 - 要注册API密钥，请访问The Movie Database（tmdb.org）的账户页面并在“API详情”部分生成新的密钥。

安装与设置##

获取代码

通过子模块

$ cd /your_app_path
$ git submodule add git@github.com:angelxmoreno/CakePHP-TMDB-Datasource.git Plugin/TmdbApi

通过克隆

$ cd /your_app_path/Plugin
$ git git@github.com:angelxmoreno/CakePHP-TMDB-Datasource.git TmdbApi

通过我不使用git但我应该使用

* Unzip this plugin into your app/Plugin/ directory
* Rename the folder to `TmdbApi`

###启用插件您需要在你的_app_path/Config/bootstrap.php文件中启用插件

CakePlugin::load('TmdbApi');

如果你已经使用了CakePlugin::loadAll();，则这不是必需的。

数据库设置

在你的your_app_path/Config/database.php中添加一个新的数据源条目

public $tmdb = array(
	'datasource' => 'TmdbApi.TmdbSource',
	'apiKey' => 'YOUR-API-KEY',
);

模型设置

创建一个模型并确保适当地添加$useDbConfig和$useTable。$useDbConfig的值应该是包含您的数据源信息的database.php属性。$useTable的值与您将通过模型访问的TMDB实体相关。以下是一个示例

class TmdbMovie extends AppModel {
	public $useDbConfig = 'tmdb';
	public $useTable = 'movies';
}

使用

$results = $this->TmdbMovie->read(null, 550);
debug($results);

$results = $this->TmdbMovie->find('first', array('conditions'=>array(
	'query'=>'Terminator',
	'append_to_response' => array('images'),
)));
debug($results);

$results = $this->TmdbMovie->find('all', array('conditions'=>array(
	'query'=>'Batman',
	'append_to_response' => true,//will auto append all applicable calls
)));
debug($results);

支持

有关支持、错误和功能请求，请使用此存储库的问题部分 - https://github.com/angelxmoreno/CakePHP-TMDB-Datasource/issues。

分支策略

master分支包含插件的最稳定最新版本。

开发分支是不稳定的，用于在发布之前测试新功能。

为此插件做出贡献

请随时通过新问题、请求、单元测试、代码修复或新功能对此插件做出贡献。如果你选择做出贡献，从develop创建一个功能分支，并发送你的pull请求。强烈鼓励为新功能和发现的问题编写单元测试。

许可

致谢

感谢

Larry Masters 和所有人为 CakePHP 做出的贡献。

特拉维斯·贝尔，电影数据库（《TMDb》）的创始人兼首席开发者。

angelxmoreno / cakephp-tmdb-datasource

维护者

详情