jinnguyen / puja

A Django-like template engine for PHP. Puja also supports validate template syntax!

Puja v1.1

Puja is a lightweight, flexible and easy PHP template engine. Inspired in django, Puja also support validate template syntax!

Install:

• Composer

composer require jinnguyen/puja
require 'vendor/autoload.php';
$puja = new Puja();

• Old style

require '/path/to/Autoload.php';
$puja = new Puja();

Some of Puja's features:

• VALIDATE TEMPLATE SYNTAX
• it is extremely fast
• no template parsing overhead, only compiles once.
• it is smart about recompiling only the template files that have changed.
• unlimited nesting of sections, conditionals, etc.
• built-in caching of template output.

Validate syntax:
Puja support validate syntax before the parser run compiler. This will helpfull for you to write template syntax.

Download
GIT: git clone https://github.com/jinnguyen/puja.git
SVN: svn checkout https://github.com/jinnguyen/puja.git
Source code: https://github.com/jinnguyen/puja/zipball/master

Bug list: https://github.com/jinnguyen/puja/issues?page=1&state=open

Example: file template: index.tpl:

{% extends master.tpl %}
{% block body %}
	Hello, {{ a }
	Welcome you go to Puja template examples
{% endblock %}

The result will be:

Puja only show debug when mode debug is enabled
** We recommend you should only enable mode debug when your app is in develop. And disable it when your app go to production. It will save a lot time to template engine parser.

Basic API Usage:

• template file: index.tpl

Hello {{ username }},
Welcome you go to the very first exmplate of Puja template.

• php file: index.php

  <?php
  require_once '/path/to/Autoload.php';
  $tpl = new Puja;
  $tpl->tpl_dir = '/path/to/template/folder/';
  $data = array(
  	'username'=>'Jin Nguyen',
  );
  $tpl->parse($template_file = 'index.tpl', $data);
  ?>

The result will show:

Hello Jin Nguyen,
Welcome you go to the very first exmplate of Puja template.

See User's guide for full information.

Template Inheritance:

• master.tpl:

==== Start Master ===
{% block body %}Master Body{% endblock body %}
{% block javascript %}Master javascript{% endblock javascript %}
==== End Master ====

• index.tpl

{% block javascript %}Index javascript{% endblock javascript %}
{% block body %}Index Body{% endblock body %}

And the result will be:

==== Start Master ===
Index Body
Index javascript
==== End Master ====

more detail >>

puja's Issues

Write tests

Add check property and method exists

<?php
ini_set('display_errors', 'On');
include '../puja.php';
$tpl = new Puja;
$tpl->template_dir = 'templates/';
$tpl->cache_dir = 'cache/';

class Test
{
    public function b()
    {
        return 321;
    }
}

$tpl->parse('test.tpl', [
    'a' => new Test
]);

Template:

{{ a.b }}

Compiled template:

<?php 
$pujaFilter = new TemplateFilter;
$pujaTags = new TemplateTags;
$ast_puja_template = '';
$ast_puja_template .= (isset($a['b']) ? $a['b'] : null);
$ast_puja_template .= '';

Add travis

Setup for multiple template dirs

Chain error

Code:

<?php
require_once __DIR__ . '/puja-master/puja.php';
$tpl = new Puja;
$tpl->tpl_dir = __DIR__ . '/templates/';
$tpl->cache_dir = __DIR__ . '/cache/';

$output = $tpl->parse('index.html', [
    'a' => [
        'b' => [
            'c' => 1
        ]
    ]
]);

Template:

Hello world {{ a.b.c }}

return Hello world

template parse error

I got a error for this tag:
{% if a in b and c in d %}

Can you help to fix it? tks!

Reformat code

Add validation for incorrect template tags and filters

How to get parent block content?

How to get parent block content? like this {{ block.super }}?

p.s. - Sorry, my english so bad.

Add composer