cinam/template-parser

Template parser

Template parser

A simple text parser. It allows you to perform following text transformations:, _(*1)

• replace placeholders with scalar variables,
• replace placeholders from array variables using iteration,
• process logical conditions.

There is no limit for nesting arrays., _(*2)

Usage

``` php $parser = new \Cinam\TemplateParser\Parser(); $result = $parser->parse($text, $variables);, <sub>(*3)</sub>

## Examples

### Example 1 - Simple variable
``` php
$text = 'Hello, {user}!';
$variables = [
    'user' => 'Peter',
];

$parser = new \Cinam\TemplateParser\Parser();
echo $parser->parse($text, $variables);

Hello, Peter!, <sub>(*4)</sub>

Example 2 - Condition

``` php $text = << highScore] Congratulations, it's the new high score! [ENDIF] EOT; $parser = new \Cinam\TemplateParser\Parser();, <sub>(*5)</sub>

echo $parser->parse($text, ['score' => 50, 'highScore' => 60]);, <sub>(*6)</sub>

*Your score: 50 points.*
``` php
echo $parser->parse($text, ['score' => 50, 'highScore' => 40]);

Your score: 50 points., <sub>(*7)</sub>

Congratulations, it's the new high score!, <sub>(*8)</sub>

Example 3 - Condition with ELSE

``` php $text = '[IF age >= 18]You are an adult[ELSE]Sorry, you are too young[ENDIF]'; $parser = new \Cinam\TemplateParser\Parser();, <sub>(*9)</sub>

echo $parser->parse($text, ['age' => 18]);, <sub>(*10)</sub>

*You are an adult*
``` php
echo $parser->parse($text, ['age' => 15]);

Sorry, you are too young, <sub>(*11)</sub>

Example 4 - Iteration

``` php $text = << personalBest]Congratulations, it's your personal best![ENDIF] [END] EOT; $variables = [ 'scores' => [ [ 'user' => 'Peter', 'score' => 20, 'personalBest' => 25, ], [ 'user' => 'Mike', 'score' => 30, 'personalBest' => 30, ], [ 'user' => 'John', 'score' => 30, 'personalBest' => 25, ], ], ];, <sub>(*12)</sub>

$parser = new \Cinam\TemplateParser\Parser(); echo $parser->parse($text, $variables); ``` Summary:, <sub>(*13)</sub>

Peter, your score is 20., <sub>(*14)</sub>

Mike, your score is 30., <sub>(*15)</sub>

John, your score is 30. Congratulations, it's your personal best!, <sub>(*16)</sub>