107 lines
1.7 KiB
PHP
107 lines
1.7 KiB
PHP
<?php
|
|
|
|
namespace Kirby\Toolkit;
|
|
|
|
use Exception;
|
|
use Kirby\Filesystem\F;
|
|
use Throwable;
|
|
|
|
/**
|
|
* Simple PHP view engine
|
|
*
|
|
* @package Kirby Toolkit
|
|
* @author Bastian Allgeier <bastian@getkirby.com>
|
|
* @link https://getkirby.com
|
|
* @copyright Bastian Allgeier
|
|
* @license https://opensource.org/licenses/MIT
|
|
*/
|
|
class View
|
|
{
|
|
/**
|
|
* Creates a new view object
|
|
*/
|
|
public function __construct(
|
|
// The absolute path to the view file
|
|
protected string $file,
|
|
protected array $data = []
|
|
) {
|
|
}
|
|
|
|
/**
|
|
* Returns the view's data array without globals
|
|
*/
|
|
public function data(): array
|
|
{
|
|
return $this->data;
|
|
}
|
|
|
|
/**
|
|
* Checks if the template file exists
|
|
*/
|
|
public function exists(): bool
|
|
{
|
|
return is_file($this->file()) === true;
|
|
}
|
|
|
|
/**
|
|
* Returns the view file
|
|
*/
|
|
public function file(): string
|
|
{
|
|
return $this->file;
|
|
}
|
|
|
|
/**
|
|
* Creates an error message for the missing view exception
|
|
*/
|
|
protected function missingViewMessage(): string
|
|
{
|
|
return 'The view does not exist: ' . $this->file();
|
|
}
|
|
|
|
/**
|
|
* Renders the view
|
|
*/
|
|
public function render(): string
|
|
{
|
|
if ($this->exists() === false) {
|
|
throw new Exception($this->missingViewMessage());
|
|
}
|
|
|
|
ob_start();
|
|
|
|
try {
|
|
F::load($this->file(), null, $this->data());
|
|
} catch (Throwable $e) {
|
|
$exception = $e;
|
|
}
|
|
|
|
$content = ob_get_contents();
|
|
ob_end_clean();
|
|
|
|
if (($exception ?? null) !== null) {
|
|
throw $exception;
|
|
}
|
|
|
|
return $content;
|
|
}
|
|
|
|
/**
|
|
* @see ::render()
|
|
*/
|
|
public function toString(): string
|
|
{
|
|
return $this->render();
|
|
}
|
|
|
|
/**
|
|
* Magic string converter to enable
|
|
* converting view objects to string
|
|
*
|
|
* @see ::render()
|
|
*/
|
|
public function __toString(): string
|
|
{
|
|
return $this->render();
|
|
}
|
|
}
|