Эта функция предназначена для внутреннего использования. Она собирает блоки из файла, соответствующего указанному $url, в том числе и блоки из всех .htaccess-файлов "надкаталогов". function CollectBlocks($url) { global $BLOCK; $url=abs path($url,dirname($GLOBALS["SCRIPT NAME"]));

Если путь - не /, то обратиться к "надкаталогу". if(strlen($url)>1) CollectBlocks(dirname($url)); Загрузить блоки самого файла. Load($url);

Главная функция шаблонизатора. Обрабат1вает указанн1й файл $url

и возвращает тело блока Output. В выходной поток ничего не печатается

( за исключением предупреждений, если они возникли).

function RunUrl($url)

{ global $BLOCK;

Собираем все блоки. CollectBlocks($url);

Находим и запускаем главн1й шаблон. Mi делаем это в последнюю очередь, чтобы ему были доступны все блоки, из которых состоит страница. Шаблон - об1чн1й блочн1й файл. В нем обязательно должен присутствовать блок Output.

$tmpl=@$BLOCK[BlkTemplate]; if(!$tmpl) {

die("Cannot find the template for <b>$url</b> ".

"(have you defined <tt>".BlkTemplate."</tt> block?)");

Load($tmpl);

Возвращаем блок Output.

if(!isSet($BLOCK[BlkOutput])) {

die("No output from template <b>$tmpl</b> ".

"(have you defined <tt>".BlkOutput."</tt> block?)");

return $BLOCK[BlkOutput];

Запускает все фильтры для блока. function ProcessContent($name,&$cont,$url) { foreach($GLOBALS["BLOCKFILTERS"] as $F) $F($name,$cont,$url);

"Склеивание" блоков.

Если тело блока начинается с [name], то оно не просто записывается в массив блоков, а " пристыковывается" к значению, уже там находящемуся, причем в качестве символа-соединителя выступает тело блока с именем name. Если строка name не задана ( то есть указаны []), используется блок с именем DefaultGlue, а если этого блока нет, то соединитель по умолчанию - " ". function FBlkGlue($name,&$cont,$url)

{ global $BLOCK;

if(ereg("-\\[([-]])*]",$cont,$P)) {

$c=substr($cont,strlen($P[0])); тело блока после [name] $n=$P[1]; имя соединителя

Есть с чем " склеивать"? if(!empty($BLOCK[$name])) {

$glue=@$BLOCK[$n];

if(!Isset($glue)) $glue=@$BLOCK[BlkDefGlue]; if(!Isset($glue)) $glue=DefGlue; $cont=$BLOCK[$name].$glue.$c;

"Склеивать" нечего - просто присваиваем. else $cont=$c;

Удаление начальн1х символов табуляции из тела блока.

Теперь можно в1равнивать HTML-код в документах с помощью табуляции.

Это оказывается чрезвычайно удобным, если мы используем тэги,

например, в таком контексте:

< ?foreach($Book as $k=>$v) {? > <tr>

<td>< ?=$Book[name]? ></td> <td>< ?=$Book[text]? ></td>

Примечание

Эти чрезвычайно полезные функции впервые введены в PHP версии 4. Нужно заметить, что без них вряд ли можно написать более-менее удобный шаблонизатор. Я привожу здесь их описания в том виде, который принят в этой книге.

void ob start()

Вызов данной функции говорит PHP, что необходимо начать "перехват" стандартного выходного потока программы. Иными словами, весь текст, который выводится операторами echo или расположен вне участков кода PHP, будет накапливаться в специальном буфере, а не отправится в браузер. В любой момент времени мы можем получить все содержимое этого буфера, вызвав функцию ob get contents(). В шаблонизаторе мы вызываем ob start() каждый раз, когда встречается начало нового блока.

string ob get contents()

Функция возвращает текущее содержимое буфера, который заполняется операторами вывода при включенном режиме буферизации. Именно ob get contents() обеспечивает в нашем шаблонизаторе возможность накопления текста блоков. Она вызывается (а возвращенные данные записываются в массив) каждый раз, когда заканчивается очередной блок (вернее, перед началом следующего блока), а также при достижении конца файла.

</tr> < ?}? >

function FBlkTabs($name,&$cont,$url)

{ используем регулярное выражение в формате PCRE, т. к. это - единственный приемлемый способ решения задачи $cont=preg replace("/\t+/m","",$cont);

?>

"Перехват" выходного потока

В коде листинга 30.14 есть всего лишь несколько вызовов стандартных функций, которые мы еще не рассматривали в этой книге. Я имею в виду функции с префиксами ob (от Output Buffering - Буферизация вывода). Их задача - "перехватить" тот текст, который выводится операторами echo, а также участками, расположенными вне PHP-тэгов <? и ?>, и направить его в строковую переменную для дальнейшей обработки.