Ob get level: примеры (PHP)

Базовый пример демонстрирует увеличение и уменьшение уровня буферизации.

<?php
echo 'Уровень 0: ' . ob_get_level() . "\n"; // 0
ob_start();
echo 'Уровень 1: ' . ob_get_level() . "\n"; // 1
ob_start();
echo 'Уровень 2: ' . ob_get_level() . "\n"; // 2
ob_end_flush();
echo 'Уровень после очистки одного: ' . ob_get_level() . "\n"; // 1
ob_end_flush();
echo 'Уровень после очистки всех: ' . ob_get_level() . "\n"; // 0
?>

Уровень 0: 0
Уровень 1: 1
Уровень 2: 2
Уровень после очистки одного: 1
Уровень после очистки всех: 0

Функция помогает безопасно закрыть все буферы.

<?php
ob_start();
ob_start();
// ... какой-то код
while (ob_get_level() > 0) {
    ob_end_flush();
}
echo 'Текущий уровень: ' . ob_get_level(); // 0
?>

Текущий уровень: 0

• ob_start() - Инициирует буферизацию вывода. Является основным способом начала буферизации, тогда как ob_get_level() лишь диагностирует состояние.
• ob_get_contents() - Возвращает содержимое текущего буфера, не затрагивая его уровень. Полезно для получения данных без отмены буферизации.
• ob_end_clean() и ob_end_flush() - Завершают буферизацию, очищая или отправляя буфер соответственно. Эти функции уменьшают уровень, возвращаемый ob_get_level().
• ob_get_status() - Возвращает массив с детальной информацией о буферах, включая уровень. Более информативна, чем ob_get_level().

ob_get_level() предпочтительнее для простой проверки количества активных буферов, особенно в циклах или условиях для контроля вложенности.

Вызов функций ob_end_clean() или ob_end_flush() при нулевом уровне вызывает ошибку.

<?php
// Нет активного буфера
ob_end_clean(); // Вызовет Notice
?>

PHP Notice: ob_end_clean(): failed to delete buffer. No buffer to delete in ...

Буферы должны завершаться в порядке, обратном их созданию. Использование ob_get_level() помогает избежать этой ошибки.

<?php
ob_start(); // Уровень 1
ob_start(); // Уровень 2
ob_end_clean(); // Корректно: завершает уровень 2
echo 'Уровень: ' . ob_get_level(); // 1
?>

Уровень: 1

Функция ob_get_level() была введена в PHP 4.2.0. С тех пор ее поведение и сигнатура оставались стабильными. В PHP 8.0 и 8.1 не было внесено значительных изменений, влияющих на работу этой функции.

<?php
function processBuffer($depth = 0) {
    ob_start();
    echo "Глубина: $depth, Уровень: " . ob_get_level() . "\n";
    if ($depth < 3) {
        processBuffer($depth + 1);
    }
    $content = ob_get_contents();
    ob_end_clean();
    return strtoupper($content);
}

echo processBuffer();
?>

ГЛУБИНА: 0, УРОВЕНЬ: 1
ГЛУБИНА: 1, УРОВЕНЬ: 2
ГЛУБИНА: 2, УРОВЕНЬ: 3
ГЛУБИНА: 3, УРОВЕНЬ: 4

<?php
function safeRender($callback) {
    $initialLevel = ob_get_level();
    ob_start();
    try {
        $callback();
        return ob_get_contents();
    } finally {
        // Гарантированная очистка всех вновь созданных буферов
        while (ob_get_level() > $initialLevel) {
            ob_end_clean();
        }
    }
}

$result = safeRender(function() {
    echo "Основной контент";
    ob_start();
    echo " Дополнительный";
    // Имитация ошибки
    throw new Exception('Ошибка рендеринга');
});
echo 'Результат: ', $result;
?>

Fatal error: Uncaught Exception: Ошибка рендеринга in ...
// Но буферы корректно очищены, утечки данных нет.

<?php
class SimpleTemplate {
    protected $level;
    public function __construct() {
        $this->level = ob_get_level();
        ob_start();
    }
    public function section($name) {
        $content = ob_get_contents();
        ob_clean();
        $this->{$name} = $content;
    }
    public function render() {
        $final = ob_get_contents();
        while (ob_get_level() > $this->level) {
            ob_end_clean();
        }
        return $final;
    }
}

$tpl = new SimpleTemplate();
?><h1>Заголовок</h1>
<?php $tpl->section('header'); ?>
<div>Контент</div>
<?php
echo $tpl->render();
var_dump($tpl->header);
?>

<h1>Заголовок</h1>
string(27) "<div>Контент</div>"

Концепция буферизации вывода существует во многих языках, но реализация отличается.

Ob get level в Python

В Python используется модуль contextlib и StringIO для буферизации строк. Прямого аналога получения уровня нет.

from io import StringIO
import sys

old_stdout = sys.stdout
sys.stdout = buffer = StringIO()
print("Это в буфере")
sys.stdout = old_stdout
print("Содержимое буфера:", buffer.getvalue())

Содержимое буфера: Это в буфере

В Node.js можно перенаправить поток вывода, но прямой аналогии с уровнями буфера нет.

const { Writable } = require('stream');
let data = '';
const myStream = new Writable({
  write(chunk, encoding, callback) {
    data += chunk;
    callback();
  }
});
// Перенаправление console.log
const originalLog = console.log;
console.log = (...args) => {
  myStream.write(args.join(' ') + '\n');
};
console.log('Сообщение в буфер');
console.log = originalLog;
console.log('Буфер содержит:', data);

Буфер содержит: Сообщение в буфер

Ob get level в MySQL

SQL не имеет функции буферизации вывода в том же контексте, что и PHP.