Merge branch 'geggleto-master'

Closes #19

Author: akrabat

README.md

@@ -2,12 +2,17 @@
 
 This is a renderer for rendering PHP view scripts into a PSR-7 Response object. It works well with Slim Framework 3.
 
+
+## Templates
+You may use `$this` inside your php templates. `$this` will be the actual PhpRenderer object will allow you to render sub-templates
+
 ## Installation
 
 Install with [Composer](http://getcomposer.org):
 
     composer require slim/php-view
 
+
 ## Usage With Slim 3
 
 ```php

src/PhpRenderer.php

@@ -11,7 +11,8 @@
 use Psr\Http\Message\ResponseInterface;
 
 /**
- * Php View
+ * Class PhpRenderer
+ * @package Slim\Views
  *
  * Render PHP view scripts into a PSR-7 Response object
  */
@@ -39,8 +40,8 @@ public function __construct($templatePath = "")
      *
      * throws RuntimeException if $templatePath . $template does not exist
      *
-     * @param \ResponseInterface $response
-     * @param                    $template
+     * @param ResponseInterface $response
+     * @param string             $template
      * @param array              $data
      *
      * @return ResponseInterface
@@ -50,6 +51,29 @@ public function __construct($templatePath = "")
      */
     public function render(ResponseInterface $response, $template, array $data = [])
     {
+        $output = $this->fetch($template, $data);
+
+        $response->getBody()->write($output);
+        
+        return $response;
+    }
+
+    /**
+     * Renders a template and returns the result as a string
+     *
+     * cannot contain template as a key
+     *
+     * throws RuntimeException if $templatePath . $template does not exist
+     *
+     * @param $template
+     * @param array $data
+     *
+     * @return mixed
+     *
+     * @throws \InvalidArgumentException
+     * @throws \RuntimeException
+     */
+    public function fetch($template, array $data = []) {
         if (isset($data['template'])) {
             throw new \InvalidArgumentException("Duplicate template key found");
         }
@@ -58,17 +82,19 @@ public function render(ResponseInterface $response, $template, array $data = [])
             throw new \RuntimeException("View cannot render `$template` because the template does not exist");
         }
 
-        $render = function ($template, $data) {
-            extract($data);
-            include $template;
-        };
-
         ob_start();
-        $render($this->templatePath . $template, $data);
-        $output = ob_get_clean(); 
+        $this->protectedIncludeScope($this->templatePath . $template, $data);
+        $output = ob_get_clean();
 
-        $response->getBody()->write($output);
-        
-        return $response;
+        return $output;
+    }
+
+    /**
+     * @param string $template
+     * @param array $data
+     */
+    protected function protectedIncludeScope ($template, array $data) {
+        extract($data);
+        include $template;
     }
 }

tests/testTemplate.php

@@ -5,4 +5,4 @@
  * Date: 2015-11-12
  * Time: 1:20 PM
  */
-print $hello;
+print $hello;