Adding doctrine cache to the suggest directive in composer.json to in…

…dicate cache support, also added an example of how this could be used.

composer.json

@@ -18,7 +18,11 @@
         "guzzle/guzzle": ">=0.7"
     },
     "require-dev": {
-        "phpunit/phpunit": ">=3.7"
+        "phpunit/phpunit": ">=3.7",
+        "doctrine/cache": ">=1.3.0"
+    },
+    "suggest": {
+        "doctrine/cache": "This library is required if you want to make use of caching features."
     },
     "autoload": {
         "psr-0": { "Tmdb\\": "lib/" }

examples/movies/model/cache/get.php

@@ -0,0 +1,32 @@
+<?php
+/**
+ * This file is part of the Tmdb PHP API created by Michael Roterman.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @package Tmdb
+ * @author Michael Roterman <[email protected]>
+ * @copyright (c) 2013, Michael Roterman
+ * @version 0.0.1
+ */
+require_once '../../../../vendor/autoload.php';
+require_once '../../../../apikey.php';
+
+$token  = new \Tmdb\ApiToken(TMDB_API_KEY);
+$client = new \Tmdb\Client($token);
+
+$cachePlugin = new \Guzzle\Plugin\Cache\CachePlugin(array(
+    'storage' => new \Guzzle\Plugin\Cache\DefaultCacheStorage(
+            new \Guzzle\Cache\DoctrineCacheAdapter(
+                new \Doctrine\Common\Cache\FilesystemCache('/tmp/_php-tmdb-api')
+            )
+        )
+));
+
+$client->getHttpClient()->addSubscriber($cachePlugin);
+
+$repository = new \Tmdb\Repository\MovieRepository($client);
+$movie      = $repository->load(87421);
+
+var_dump($movie);