pagekit/razr

Razr - The powerful PHP template engine

Razr - The powerful PHP template engine

Razr is a powerful PHP template engine for PHP, whose syntax was inspired by ASP.NET Razor., _(*1)

Usage

Render a template:, _(*2)

$razr = new Razr\Engine(new Razr\Loader\StringLoader);
echo $razr->render('Hello @( $name )!', array('name' => 'World'));

Render a template file with caching:, _(*3)

$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., _(*4)

Echo data

Use the @() notation to echo any PHP data with escaping enabled by default., _(*5)

Example, _(*6)

<h1>@( $title )</h1>
@( 23 * 42 )
@( "<Data> is escaped by default." )

Output, _(*7)

<h1>Some title</h1>
966
&lt;Data&gt; is escaped by default.

Echo raw data

Use the @raw() directive to output any PHP data without escaping., _(*8)

Example, _(*9)

@raw("This will <strong>not</strong> be escaped.")

Output, _(*10)

This will <strong>not</strong> be escaped.

Variables

You can access single variables and nested variables in arrays/objects using the following dot . notation., _(*11)

array(
    'title' => 'I am the walrus',
    'artist' => array(
        'name' => 'The Beatles',
        'homepage' => 'http://www.thebeatles.com',
    )
)

Example, _(*12)

<h1>@( $title )</h1>
<p>by @( $artist.name ), @( $artist.homepage )</p>

Output, _(*13)

<h1>I am the walrus</h1>
<p>by The Beatles, http://www.thebeatles.com</p>

Set variable values

Example, _(*14)

@set($msg = "Hello World!")
@( $msg )

Output, _(*15)

Hello World!

Conditional control structures

Use @if, @elseif, @else for conditional control structures. Use any boolean PHP expression., _(*16)

Example, _(*17)

@set($expression = false)
@if( $expression )
    One.
@elseif ( !$expression ) 
    Two.
@else
    Three.
@endif

Output, _(*18)

Two.

Loops

You can use loop statements like foreach and while., _(*19)

@foreach($values as $key => $value)


@( $key ) - @( $value ), (*20)



@endforeach

@foreach([1,2,3] as $number)


@( $number ), (*21)


@endforeach

@while(true)


Infinite loop., (*22)


@endwhile

Include

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., _(*23)

Example, _(*24)

<section>@include('partial.razr', ['param' => 'parameter'])</section>

partial.razr:, _(*25)

<p>Partial with @( $param )<p>

Output, _(*26)

<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., _(*27)

Example, _(*28)

@include('child.razr', ['param' => 'parameter'])

parent.razr:, _(*29)

Parent template



@block('contentblock')


Parent content., (*30)



@endblock



Parent content outside of the block., (*31)

child.razr:, _(*32)

@extend('parent.razr')

@block('contentblock')


You can extend themes and overwrite content inside blocks. Paremeters are available as well: @( $param )., (*33)


@endblock

Output, _(*34)

Parent template





You can extend themes and overwrite content inside blocks. Paremeters are available as well: parameter., (*35)






Parent content outside of the block., (*36)