PHP SwiftRender is a pure PHP advanced template library. It offers several advantages for developers who need to create and render templates in PHP applications. Firstly, it can improve performance, as there is no need for an additional language or engine to process the template. This can result in faster rendering times and reduced overhead. Additionally, a pure PHP template library is highly portable, as it can be used in almost any PHP application, regardless of the underlying platform or framework.
PHP SwiftRender offers greater flexibility and control over the rendering process. Developers that knows PHP can structure and design their templates in ways that better suit their specific needs, resulting in more efficient and effective templates.
PHP is a widely-used language, most developers are already familiar with its syntax and conventions. This makes it easier to learn and use a pure PHP template library than an entirely new templating language or engine.
One time setup to use through the application.
use MaplePHP\Output\SwiftRender;
use MaplePHP\DTO\Format;
$swift = new SwiftRender();
$swift->setIndexDir(dirname(__FILE__)."/resources/") // Set index directory
->setViewDir(dirname(__FILE__)."/resources/views/") // Set view directory
->setPartialDir(dirname(__FILE__)."/resources/partials/"); // Set partials directory
// Prepare/bind "/resources/index.php"
$swift->setIndex("index");
// Prepare/bind "/resources/views/main.php"
$swift->setView("main");
// Prepare/bind "/resources/partials/article.php"
$swift->setPartial("article", [
"date" => "2023-02-30 15:33:22",
"name" => "This is an article",
"content" => "Lorem ipsum dolor sit amet, consectetur adipisicing elit.",
"feed" => [
[
"headline" => "test 1",
"description" => "Lorem ipsum dolor sit amet, consectetur adipisicing elit. Sunt, architecto."
],
[
"headline" => "test 2",
"description" => "Lorem ipsum dolor sit amet, consectetur adipisicing elit. Sunt, architecto."
]
]
]);
// Keep in mind that the data usually comes from the database and that it should/might be called from you controller.
// E.g. $swift->setPartial("article", $mysqli->fetch_objects());The file /resources/index.php has already been bounded under the initialisation section above $swift->setIndex("index"). The file looks like this:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- Used to create dynamic HTML tags, the below will create the metadata
explained bellow under the section "Easy DOM manipulation" -->
<?php echo \MaplePHP\Output\Dom\Document::dom("head")->execute(); ?>
</head>
<body>
<?php echo $this->partial("navigation")->get(); ?>
<main>
<?php echo $this->view()->get(); ?>
</main>
</body>
</html>The file /resources/views/main.php has already been bounded under the initialisation section above $swift->setView("main"). The file looks like this:
<div id="wrapper">
<?php echo $this->partial("article")->get(); ?>
</div>The file /resources/partials/article.php has already been bounded under the initialisation section above $swift->setPartial("article", ...). The file looks like this:
<article>
<header>
<h2><?php echo $name; ?></h2>
<h6><?php echo $date->clockFormat("Y/m/d"); ?></h6>
<p><?php echo $content->stExcerpt(20); ?></p>
</header>
<?php if($feed->count() > 0): ?>
<ul>
<?php foreach($feed->fetch() as $row): ?>
<li>
<strong><?php echo $row->headline->strUcFirst(); ?></strong><br>
<?php echo $row->description; ?>
</li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
</article>The partials all arguments will automatically be converted to an object with a lot of extended functionality. Here is some:
echo $date; // 2023-02-30 15:33:22
echo $date->clockFormat("Y/m/d"); // 2023/02/30
// Will strip all html tags, replace regular line breaks with "<br>" and uppercase the first letter
echo $content->strStripTags()->strNl2br()->strUcfirst();
// Loop through an array
if($feed->count() > 0) foreach($feed->fetch() as $row) {
echo $row->headline->strUcFirst() . "<br>";
}You can run the template engine later in an empty file, emitter or router dispatcher. It all depends on your setup.
echo $swift->index()->get();You can also create a dynamic view that will overwrite the current view if called. This is great for e.g. showing a 404 page.
In this example the current view which is /resources/views/main will be replaced with the view /resources/views/httpStatus.php when response status code is (403, 404 e.g.).
// MaplePHP framework (PSR response). Just using this in this example to handle status response codes
use MaplePHP\Http\Response;
$swift->bindToBody(
"httpStatus",
Format\Arr::value(Response::PHRASE)->unset(200, 201, 202)->arrayKeys()->get()
// This method will load all HTTP Request status codes (like 403, 404 e.g.) except for (200, 201, 202)
);
$swift->findBind($response->getStatusCode());Advance DOM creation and works great with stuff like the Metadata because you can later in change values and attributes in the controller.
// Advance DOM creation and works great with stuff like the Metadata
$dom = MaplePHP\Output\Dom\Document::dom("head");
$dom->bindTag("title", "title")->setValue("Meta title");
$dom->bindTag("meta", "description")->attr("name", "Description")->attr("content", "Lorem ipsum dolor sit amet.");
// Then later in controller you can change the meta title and description
$head = MaplePHP\Output\Dom\Document::dom("head");
$head->getElement("title")->setValue("New meta title");
$head->getElement("description")->attr("content", "New meta description...");