PHP Renderer
This is a renderer for rendering PHP view scripts into a PSR-7 Response object. It works well with Slim Framework 4.
Cross-site scripting (XSS) risks
Note that PHP-View has no built-in mitigation from XSS attacks. It is the developer's responsibility to use htmlspecialchars() or a component like laminas-escaper. Alternatively, consider Twig-View.
Installation
Install with Composer:
composer require slim/php-view
Usage with Slim 4
use Slim\Views\PhpRenderer;
include "vendor/autoload.php";
$app = Slim\AppFactory::create();
$app->get('/hello/{name}', function ($request, $response, $args) {
$renderer = new PhpRenderer('path/to/templates');
return $renderer->render($response, "hello.php", $args);
});
$app->run();
Note that you could place the PhpRenderer instantiation within your DI Container.
Usage with any PSR-7 Project
//Construct the View
$phpView = new PhpRenderer("path/to/templates");
//Render a Template
$response = $phpView->render(new Response(), "hello.php", $yourData);
Template Variables
You can now add variables to your renderer that will be available to all templates you render.
// via the constructor
$templateVariables = [
"title" => "Title"
];
$phpView = new PhpRenderer("path/to/templates", $templateVariables);
// or setter
$phpView->setAttributes($templateVariables);
// or individually
$phpView->addAttribute($key, $value);
Data passed in via ->render() takes precedence over attributes.
$templateVariables = [
"title" => "Title"
];
$phpView = new PhpRenderer("path/to/templates", $templateVariables);
//...
$phpView->render($response, $template, [
"title" => "My Title"
]);
// In the view above, the $title will be "My Title" and not "Title"
Sub-templates
Inside your templates you may use $this to refer to the PhpRenderer object to render sub-templates. If using a layout the fetch() method can be used instead of render() to avoid appling the layout to the sub-template.
<?=$this->fetch('./path/to/partial.phtml', ["name" => "John"])?>
Rendering in Layouts
You can now render view in another views called layouts, this allows you to compose modular view templates and help keep your views DRY.
Create your layout path/to/templates/layout.php.
<html><head><title><?=$title?></title></head><body><?=$content?></body></html>
Create your view template path/to/templates/hello.php.
Hello <?=$name?>!
Rendering in your code.
$phpView = new PhpRenderer("path/to/templates", ["title" => "My App"]);
$phpView->setLayout("layout.php");
//...
$phpview->render($response, "hello.php", ["title" => "Hello - My App", "name" => "John"]);
Response will be
<html><head><title>Hello - My App</title></head><body>Hello John!</body></html>
Please note, the $content is special variable used inside layouts to render the wrapped view and should not be set in your view paramaters.
Exceptions
\RuntimeException - if template does not exist
\InvalidArgumentException - if $data contains 'template'
3 Jan 6, 2022
996 Dec 28, 2022
54 Sep 21, 2022
204 Dec 23, 2022
4 Nov 5, 2022
32 May 24, 2021
52 Jul 17, 2022
7.3k Jan 4, 2023
25 Oct 30, 2022
5 May 31, 2022
1.3k Dec 22, 2022
22 Dec 20, 2022
51 Sep 21, 2022
6 Nov 17, 2022
308 Nov 7, 2022
2 Jan 9, 2022
5 Apr 2, 2022
76 Jul 23, 2022
4 Dec 17, 2022