Работа с библиотекой CTPP

Оглавление

• Введение
• Перед тем, как начать
• Простой пример
• Пример посложнее
• Циклы и функции
• Использование Include
• Обработка ошибок
• Блоки данных

Введение

Перед тем, как начать

// Создаем объект
$Template = ctpp_new();

// Правильно
$Params = Array("number_one" => 1,
                "number.pi"  => 3.14,
                "text"       => "Hello, World!");

// Неправильно
                     // Ключ не может начинаться с цифры
$WrongParams = Array("1one"       => 1,
                     // В имени ключа нельзя указать знак '-'
                     "number-pi"  => 3.14,
                     // Имя ключа не должно содержать русских букв
                     "текст"      => "Hello, World!");

// Передаем данные в шаблонизатор
ctpp_emit_params($Template, $Params);

// Необходимо вставить еще параметры? Без проблем!
ctpp_emit_params($Template, Array("param" => "Дополнительный параметр"));

// Выводим данные
ctpp_dump_params($Template);

Простой пример

<?php
// Параметры для вывода
$Params = Array("hello" => "Привет", "who" => "Мир");

// Создаем шаблонизатор
$Template = ctpp_new();

// Загружаем шаблон
$Bytecode = ctpp_parse_template($Template, "hello.tmpl");

// Выводим данные
ctpp_emit_params($Template, $Params);

// Печатаем результат
echo ctpp_output_string($Template, $Bytecode);
?>

	<TMPL_var hello>, <TMPL_var who>!

Пример посложнее

<?php
$Age = _GET['age'];

if ($Age < 18)
{
	echo "Детям до 18 - только детские разделы сайта!";
}
else
{
	echo "А вот взрослым - все, что угодно!";
}
?>

	<TMPL_if (age < 18)>
		Вам меньше 18 лет!
	<TMPL_else>
		Вам больше 18 лет!
	</TMPL_if>

	<TMPL_if (age < 7 || age > 18)>
		Привет-привет!
	<TMPL_else>
		Вход только для школьников!
	</TMPL_if>

	<TMPL_if (forum.posts < 100)>
		Новичок
	<TMPL_elsif (forum.posts < 300)>
		Участник
	<TMPL_elsif (forum.posts < 500)>
		Активный участник
	<TMPL_elsif (forum.posts < 1000)>
		Старожил
	<TMPL_elsif (forum.posts < 2000)>
		Аксакал
	<TMPL_elsif (forum.posts < 5000)>
		Многописатель
	<TMPL_else>
		Гуру
	</TMPL_if>

<?php

$Age   = $_GET['age']   * 1;
$Posts = $_GET['posts'] * 1;
// Параметры для вывода
$Params = Array("age" => $Age, "forum.posts" => $Posts);

// Создаем шаблонизатор
$Template = ctpp_new();

// Загружаем шаблон
$Bytecode = ctpp_parse_template($Template, "branches.tmpl");

// Выводим данные
ctpp_emit_params($Template, $Params);

// Печатаем результат
echo ctpp_output_string($Template, $Bytecode);
?>

Циклы и функции

<?php
$LoopBody = Array( Array("id" => 1, "iteration" => "первая"),
                   Array("id" => 2, "iteration" => "вторая"),
                   Array("id" => 3, "iteration" => "третья"),
                   Array("id" => 3, "iteration" => "четвертая") );
?>

	<TMPL_loop loop_body>
		ID: <TMPL_var id>, итерация: <TMPL_var iteration>
	</TMPL_loop>

<?php
	// Выводим данные
	ctpp_emit_params($Template, Array("loop_body" => $LoopBody) );
?>

• __FIRST__ - установлена в "1" во время первой итерации цикла. Во всех остальных случаях не определена.
• __LAST__ - содержит номер последней итерации во время последней итерации цикла. Во всех остальных случаях не определена.
• __INNER__ - содержит номер итерации со второй по предпоследнюю. Во всех остальных случаях не определена.
• __ODD__ - установлена, когда номер итерации нечетен. Содержит номер итерации. Для четных итераций не определена.
• __COUNTER__ - определена во всех итерациях и содержит текущий номер итерации. Нумерация в цикле начинается с единицы.
• __EVEN__ - установлена, когда номер итерации четен. Содержит номер итерации. Для нечетных итераций не определена.
• __SIZE__ - определена во всех итерациях внутри цикла и содержит полное количество итераций.
• __CONTENT__ - определена во всех итерациях внутри цикла и содержит данные, находящиеся в текущей ячейке массива.

<?php
// Внешний цикл
$LoopBody = Array();
for ($i = 0; $i < 5; ++$i)
{
	// Внутренний цикл
	$inner_loop = Array();
	for ($j = 0; $j < 5; ++$j)
	{
		$inner_loop[$j]["inner_id"] = $j;
	}

	$LoopBody[$i]["id"] = $i;
	$LoopBody[$i]["inner_loop"] = $inner_loop;
}

ctpp_emit_params($Template, Array("loop_body" => $LoopBody) );
?>

	<TMPL_loop loop_body>
		ID: <TMPL_var id>,
		Внутренний цикл:
		<TMPL_loop inner_loop>
			<TMPL_var inner_id>
		</TMPL_loop>
	</TMPL_loop>

Использование Include

<?php
	ctpp_include_dirs($Template,
	                  Array("/usr/share/templates", "/home/myproject/tmpl") );
?>

Обработка ошибок

<?php
	// Выводим HTML
	$OutputHTML = ctpp_output_string($Template, $Bytecode);
	if ($OutputHTML === false)
	{
		$ErrorDescr = ctpp_get_last_error($Template);
		printf("Ошибка 0x%08X: %s\n", $ErrorDescr["error_code"],
		             htmlspecialchars($ErrorDescr["error_str"]));

		printf("Файл %s: строка %d, позиция %d\n",
		                                   $ErrorDescr["template_name"],
		                                   $ErrorDescr["line"],
		                                   $ErrorDescr["pos"]);
	}
?>

Блоки

<?php
ctpp_emit_params($Template, Array("block_name" => "новости") );
?>

Описываем блоки
<TMPL_block "новости">
	Новости
</TMPL_block>
<TMPL_block "голосование">
	Новости
</TMPL_block>

Выводим тот блок, который требуется:
<TMPL_call block_name>