Razr - The powerful PHP template engine
Razr is a powerful PHP template engine for PHP, whose syntax was inspired by ASP.NET Razor.
Usage
Render a template:
$razr = new Razr\Engine(new Razr\Loader\StringLoader);
echo $razr->render('Hello @( $name )!', array('name' => 'World'));Render a template file with caching:
$razr = new Razr\Engine(new Razr\Loader\FilesystemLoader(__DIR__), '/path/to/cache');
echo $razr->render('hello.razr.php', array('name' => 'World'));Syntax
The Razr syntax uses @ as special character. It is used to indicate a dynamic statement for the template engine. Within the @() notation you may use regular PHP. The following statements are supported.
Echo data
Use the @() notation to echo any PHP data with escaping enabled by default.
Example
<h1>@( $title )</h1>
@( 23 * 42 )
@( "<Data> is escaped by default." )Output
<h1>Some title</h1>
966
<Data> is escaped by default.Echo raw data
Use the @raw() directive to output any PHP data without escaping.
Example
@raw("This will <strong>not</strong> be escaped.")Output
This will <strong>not</strong> be escaped.Variables
You can access single variables and nested variables in arrays/objects using the following dot . notation.
array(
'title' => 'I am the walrus',
'artist' => array(
'name' => 'The Beatles',
'homepage' => 'http://www.thebeatles.com',
)
)Example
<h1>@( $title )</h1>
<p>by @( $artist.name ), @( $artist.homepage )</p>Output
<h1>I am the walrus</h1>
<p>by The Beatles, http://www.thebeatles.com</p>Set variable values
Example
@set($msg = "Hello World!")
@( $msg )Output
Hello World!Conditional control structures
Use @if, @elseif, @else for conditional control structures. Use any boolean PHP expression.
Example
@set($expression = false)
@if( $expression )
One.
@elseif ( !$expression )
Two.
@else
Three.
@endifOutput
Two.Loops
You can use loop statements like foreach and while.
@foreach($values as $key => $value)
<p>@( $key ) - @( $value )</p>
@endforeach
@foreach([1,2,3] as $number)
<p>@( $number )</p>
@endforeach
@while(true)
<p>Infinite loop.</p>
@endwhileInclude
Extract reusable pieces of markup to an external file using partials and the @include directive. You can pass an array of arguments as a second parameter.
Example
<section>@include('partial.razr', ['param' => 'parameter'])</section>partial.razr:
<p>Partial with @( $param )<p>Output
<section><p>Partial with parameter<p><section>Extending templates with blocks
Use the @block directive to define blocks inside a template. Other template files can extend those files and define their own content for the defined blocks without changing the rest of the markup.
Example
@include('child.razr', ['param' => 'parameter'])parent.razr:
<h1>Parent template</h1>
@block('contentblock')
<p>Parent content.</p>
@endblock
<p>Parent content outside of the block.</p>child.razr:
@extend('parent.razr')
@block('contentblock')
<p>You can extend themes and overwrite content inside blocks. Paremeters are available as well: @( $param ).</p>
@endblockOutput
<h1>Parent template</h1>
<p>You can extend themes and overwrite content inside blocks. Paremeters are available as well: parameter.</p>
<p>Parent content outside of the block.</p>