(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
ob_get_status — Получает статус буфера вывода
Функция ob_get_status() возвращает информацию о состоянии буфера верхнего уровня
или на всех уровнях активных буферов, если параметр full_status установлен в true.
Если параметр full_status опущен или равен false,
возвращает простой массив с информацией о статусе активного уровня вывода.
Если параметр full_status равен true,
возвращает массив с одним элементом для каждого активного уровня буфера вывода.
Уровень вывода будет указан как ключ верхнего уровня массива
и каждый элемент массива сам будет другим массивом
с информацией о статусе одного активного уровня вывода.
Возвращает пустой массив, если буферизация вывода не была включена.
| Key | Value |
|---|---|
| name | Имя активного обработчика вывода (подробнее об этом рассказано в описании возвращаемых значений функции ob_list_handlers()). |
| type |
0 (внутренний обработчик)
или 1 (предоставленный пользователем обработчик)
|
| flags |
Битовая маска флагов, заданных в функции ob_start(),
тип обработчика вывода (см. выше)
и статус процесса буферизации
(константы
PHP_OUTPUT_HANDLER_*
).
Если обработчик успешно обработал буфер и не вернул false,
будут установлены значения констант
PHP_OUTPUT_HANDLER_STARTED
и PHP_OUTPUT_HANDLER_PROCESSED.
Если обработчик не смог обработать буфер или вернул false,
будут установлены значения констант
PHP_OUTPUT_HANDLER_STARTED
и PHP_OUTPUT_HANDLER_DISABLED.
|
| level |
Уровень вложенности вывода (начинается с нуля).
Заметьте, что значение, возвращаемое функцией ob_get_level()
для того же уровня, больше на единицу.
Первый уровень для функции ob_get_status() — это 0,
а для функции ob_get_level() — это 1.
|
| chunk_size | Размер части в байтах. Значение, устанавленное в функции ob_start(), или значение настройки output_buffering, если она включена и её значение установлено как целое положительное число. |
| buffer_size | Размер буфера вывода в байтах. |
| buffer_used | Размер данных буфера вывода в байтах (то же, что и возвращаемое функцией ob_get_length() целочисленное значение). |
Пример #1 Массив, который будет возвращён, если значение параметра full_status равно false
Array
(
[name] => URL-Rewriter
[type] => 0
[flags] => 112
[level] => 2
[chunk_size] => 0
[buffer_size] => 16384
[buffer_used] => 1024
)
Пример #2 Массив, который будет возвращён, если значение параметра full_status равно true
Array
(
[0] => Array
(
[name] => default output handler
[type] => 0
[flags] => 112
[level] => 1
[chunk_size] => 0
[buffer_size] => 16384
[buffer_used] => 2048
)
[1] => Array
(
[name] => URL-Rewriter
[type] => 0
[flags] => 112
[level] => 2
[chunk_size] => 0
[buffer_size] => 16384
[buffer_used] => 1024
)
)
The fields inside the array returned by ob_get_status() are:
Array
(
[name] => default output handler
[type] => 0
[flags] => 112
[level] => 1
[chunk_size] => 0
[buffer_size] => 16384
[buffer_used] => 0
)
These values are filled just after the function ob_start()