array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.ob-get-status.php', 1 => 'ob_get_status', ), 'up' => array ( 0 => 'ref.outcontrol.php', 1 => 'Функции контроля вывода', ), 'prev' => array ( 0 => 'function.ob-get-level.php', 1 => 'ob_get_level', ), 'next' => array ( 0 => 'function.ob-implicit-flush.php', 1 => 'ob_implicit_flush', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/outcontrol/functions/ob-get-status.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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 ) )