Scenic View is a tiny library that provides view and template inheritance. The syntax is straight PHP but is very clean and expressive.
The following examples use PHP short syntax (to provide cleaner views) which is fine
if you have control over your own server. NOTE: you should definitely use <?php ?>
if you are planning to distribute your code or do not have admin access to your server.
$view = new Scenic\View('path/to/views');
echo $view->render('index.php', array('title' => 'Welcome', 'name' => 'Chris'));
Create a layout (template) file that other files will extend. The $show()
method displays
a section of content that's defined by a child view extending it.
<html>
<head>
<title><?= $title ?></title>
</head>
<body>
<? $show('content') ?>
</body>
</html>
Create your view that extends the layout and provides the content for the section.
<? $extends('template.php') ?>
<? $section('content') ?>
<h1>Welcome, <?= $name ?></h1>
<? $end() ?>
What if you want to provide content in the parent, but extend that in the child? You can!
Define a section in the template.
<html>
<head>
<title><?= $title ?></title>
</head>
<body>
<? $section('content') ?>
<h1>Welcome, <?= $name ?></h1>
<? $end() ?>
</body>
</html>
Use the @parent
key in the view to specify where you want the parent content to appear.
<? $extends('template.php') ?>
<? $section('content') ?>
@parent
<p>We hope you have a great stay!</p>
<? $end() ?>
or
<? $extends('template.php') ?>
<? $section('content') ?>
<p>We hope you have a great stay!</p>
@parent
<? $end() ?>
Including partial views, like headers or footers, is easy as well.
<html>
<head>
<title><?= $title ?></title>
</head>
<body>
<? $section('content') ?>
<h1>Welcome, <?= $name ?></h1>
<? $end() ?>
<? $include('footer.php') ?>
</body>
</html>