ob_get_status

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

ob_get_status — Отримує статус буфера виводу

Опис

ob_get_status(bool $full_status = false): array

Функцияob_get_status() повертає інформацію про стан буфера верхнього рівня або на всіх рівнях активних буферів, якщо параметр full_statusустановлен в**true**

Список параметрів

full_status

Якщо **true**то поверне всі рівні активних буферів. Якщо false або не встановлений, то поверне статус лише найвищого рівня.

Значення, що повертаються

Якщо параметр full_status опущений або дорівнює false, Повертає простий масив з інформацією про статус активного рівня виведення.

Якщо параметр full_statusравен**true**, повертає масив з одним елементом кожного активного рівня буфера виведення. Рівень виведення буде вказано як ключ верхнього рівня масиву, і кожен елемент масиву сам буде іншим масивом з інформацією про статус активного рівня виведення.

Повертає порожній масив, якщо буферизація виводу була включена.

Елементи масиву, які повертає функція ob_get_status()

Key	Value
name	Ім'я активного обробника висновку (докладніше про це розказано в описі значень функції, що повертаються) ob_list_handlers()
type	(внутрішній обробник) або (наданий користувачем обробник)
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() - це , а для функції ob_get_level() - це
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 ([ ] => 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
    )

) .

Дивіться також

• ob_get_level() - Повертає рівень вкладеності механізму буферизації виводу
• ob_list_handlers() - Повертає список активних обробників виводу
• ob_get_length() - Повертає розмір буфера виводу
• ob_start() - Включає буферизацію виводу