Git Product home page Git Product logo

razr's Introduction

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
&lt;Data&gt; 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.
@endif

Output

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>
@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.

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>
@endblock

Output

<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>

razr's People

Contributors

floriandotpy avatar janschoenherr avatar steffans avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.