YerTPL - a fast and lightweight PHP template engine

YerTPL.zip
Version 1.0
modified Nov. 26, 2010
582 Downloads

What YerTPL can do?

fill simple placeholders
repeating blocks by array
if and else structur
- checking, if an placeholderdata exist´s or not
- checking, if an placeholderdata is a string or array
additional PHP-code in template possible

What YerTPL is?

YerTPL is just a simple PHP-function under 4KB with three parameters.
YerTPL($template,$data,'echo or return');

all in one example

<?php
	
	require_once('yertpl.php');
	
	$data['simple'] = 'hello';
	$data['array'][0] = 'hello';
	$data['array'][1] = 'world';
	$data['multiarray'][0]['first'] = 'hello';
	$data['multiarray'][0]['second'] = 'world';
	$data['multiarray'][0]['more'][0] = 'one';
	$data['multiarray'][0]['more'][1] = 'two';

	$template = "
		
		<!--if simple if-->
			<p>{simple}</p>
		<!--else-->
			<p>none</p>
		<!--if-->
		
		<!--!if simple if-->
			<p>none</p>
		<!--if-->
		
		<!--if.array array if-->
			<ul>
			<!--each array each-->
				<li>{key} {value}</li>
			<!--each-->
			</ul>
		<!--if-->
		
		<!--if.array multiarray if-->
			<ul>
			<!--each multiarray each-->
				<li>{key} {value['first']} {value['second']}</li>
				
				<!--if.array value['more'] if-->
				<ul>
				<!--each value['more'] each-->
					<li>{key} {value}</li>
				<!--each-->
				</ul>
				<!--if-->
				
			<!--each-->
			</ul>
		<!--if-->
		
		<?php if(\$data['simple']) \{echo \$data['simple'];\} ?>

	";

	YerTPL($template,$data,'echo');
	
	// or
	
	$view = YerTPL($template,$data,'return');
	// do something else with $view
	echo $view;

?>

more examples

simple placeholders

<?php
    
	$data['name'] = 'Joe';
    
	$template = '<p>{name}</p>';
    
	YerTPL($template,$data,'echo');
    
	// Produces: <p>Joe<p>
?>

repeating a block

<?php
    
	$data['names'] = array(
		'1' => 'Joe',
		'2' => 'Mike',
		'3' => 'Ben'
	);

	$template = '
		<ul>
		<!--each names each-->
			<li>{key} {value}</li>
		<!--each-->
		</ul>
	';

	YerTPL($template,$data,'echo');

	/* Produces: 
		<ul>
			<li>1 Joe</li>
			<li>2 Mike</li>
			<li>3 Ben</li>
		</ul>
	*/
?>

using database-result like arrays

<?php

	$data['result'] = array(
		0 => array(
			'surename' => 'Joe',
			'familyname' => 'Turner'
		),
		1 => array(
			'surename' => 'Mike',
			'familyname' => 'Smith'
		)
	);

	$template = "
		<ul>
		<!--each result each-->
			<li>{value['surename']} {value['familyname']}</li>
		<!--each-->
		</ul>
	";

	YerTPL($template,$data,'echo');

	/* Produces: 
		<ul>
			<li>Joe Turner</li>
			<li>Mike Smith</li>
		</ul>
	*/
?>;

an if structur wraps a link around an image or not

<?php

	$data['image_href'] = 'images/full.jpg';

	$template = '
		<!--if image_href if-->
		<a href="{image_href}">
		<!--if-->
			<img src="images/thumb.jpg" />
		<!--if image_href if-->
		</a>
		<!--if-->
	';

	YerTPL($template,$data,'echo');

	/* Produces: 

		// if is image_href
		<a href="images/full.jpg">
			<img src="images/thumb.jpg" />
		</a>

		// if is not image_href
		<img src="images/thumb.jpg" />

	*/
?>