Листинг 30.15. Пример "перехвата" выходного потока

<?

ob start(); устанавливаем перехват в буфер 1 echo "1" попадет в 1-й буфер

ob start(); откладываем на время буфер 1 и активизируем второй echo "2"; текст попадет в буфер 2

$A[2]=ob get contents(); текст во втором буфере ob end clean(); отключает буфер 2 и активизируем первый

echo "1"; попадет опять в буфер 1

$A[1]=ob get contents(); текст в первом буфере

Примечание

В случае, если буферизация выходного потока не была включена, функция возвращает false. Это свойство можно использовать для проверки того, установлен ли буфер вывода, или же данные сразу направляются в браузер.

void ob end clean()

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

void ob end flush()

Эта функция практически полностью эквивалентна ob end clean(), за исключением того, что данные, накопленные в буфере, немедленно выводятся в браузер пользователя. Ее применение оправдано, если мы хотим отправлять данные страницы клиенту, параллельно записывая их в переменную для дальнейшей обработки.

Стек буферов

Необходимо сделать несколько замечаний насчет функций "перехвата" выходного потока программы. Что получится, если больше одного раза подряд вызвать ob start() ? Хотя об этом не написано ни слова в официальной документации, рискну взять на себя ответственность и заявить, что, в общем-то, ничего нежелательного не произойдет. Последующие операторы вывода будут работать с тем буфером, который был установлен самгм последним вызовом. При этом функция ob end clean() не завершит буферизацию, а просто установит в активное состояние "пред1дущий" буфер (разумеется, сохранив его предхдущее содержимое). Легче всего понять этот механизм на примере:

ob end clean(); т. к. это последний буфер, буферизация отключается Распечат1ваем значения буферов, которые сохранили в массиве foreach($A as $i=>$t) echo "$i: $t<br>"; Выводится:

2: 2 1: 11

?>

Мы видим, что схема буферизации выходного потока чем-то похожа на стек: всегда используется тот буфер, который был активизирован последним. У такой схемы довольно много положительных черт, но есть и одна отрицательная. А именно, если какая-то логическая часть программы использует буферизацию выходного потока, но по случайности "забудет" вызвать ob end clean() перед своим завершением, оставшаяся программа останется "в недоумении", что же произошло. К сожалению, в PHP мы никак не сможем обойти это ограничение, так что призываю вас быть особенно внимательными.

Проблемы с отладкой

В последней версии PHP на момент написания этих строк имелось небольшое неудобство, которое может превратить отладку программ, использующих буферизацию, в сущий ад. Дело в том, что при включенной буферизации все предупреждения, в нормальном состоянии генерируемые PHP, записываются в буфер, а потому (если программа не отправляет буфер в браузер) могут потеряться. К счастью, это касается лишь предупреждений, которые не завершают работу сценария немедленно. Фатальные ошибки отправляются в браузер почти всегда. Неприятность как раз и состоит в этом "почти". Даже фатальные ошибки останутся программистом незамеченными, если он вызывает функцию ob start() вложенным образом, - т. е. более одного раза, как это было описано в предхдущем абзаце. Например, если в листинге 30.15 после присваивания текста элементу массива $A[2] вставить вызов несуществующей функции, программа сразу же выдаст пользователю текущее содержимое буфера номер 1, а затем, "не сказав ни слова", завершится. Это и понятно: ведь сообщение об ошибке попало во второй буфер, а значит, было проигнорировано! Почему разработчики PHP, вопреки общеизвестной практике, не разделили стандартный выходной поток и поток ошибок, остается неясным.

Если вы заметили, шаблонизатор всегда использует не более одного буфера "перехвата" в каждый момент времени. Это сделано именно из соображений упрощения отладки сценариев. И все же, если нефатальное предупреждение было сгенерировано в момент обработки блока, который по каким-то причинам не входит в шаблон страницы, оно останется незамеченным программистом. Впрочем, наверное, в этом нет ничего страшного: раз блок не выводится, значит, нам все равно, правильно он отработан или нет .