<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Get status of output buffers</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.ob-get-level.html">ob_get_level</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.ob-gzhandler.html">ob_gzhandler</a></div>
<div class="up"><a href="ref.outcontrol.html">Output Control Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.ob-get-status" class="refentry">
<div class="refnamediv">
<h1 class="refname">ob_get_status</h1>
<p class="verinfo">(PHP 4 >= 4.2.0, PHP 5)</p><p class="refpurpose"><span class="refname">ob_get_status</span> — <span class="dc-title">Get status of output buffers</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.ob-get-status-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">array</span> <span class="methodname"><strong>ob_get_status</strong></span>
([ <span class="methodparam"><span class="type">bool</span> <code class="parameter">$full_status</code> <span class="initializer"> = FALSE</span></span>
] )</div>
<p class="para rdfs-comment">
<span class="function"><strong>ob_get_status()</strong></span> returns status information on either
the top level output buffer or all active output buffer levels if
<em><code class="parameter">full_status</code></em> is set to <strong><code>TRUE</code></strong>.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.ob-get-status-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">full_status</code></em></span>
<dd>
<p class="para">
<strong><code>TRUE</code></strong> to return all active output buffer levels. If <strong><code>FALSE</code></strong> or not
set, only the top level output buffer is returned.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.ob-get-status-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
If called without the <em><code class="parameter">full_status</code></em> parameter
or with <em><code class="parameter">full_status</code></em> = <strong><code>FALSE</code></strong> a simple array
with the following elements is returned:
<div class="informalexample">
<div class="example-contents screen">
<div class="returnvaluescode"><pre class="returnvaluescode">Array
(
[level] => 2
[type] => 0
[status] => 0
[name] => URL-Rewriter
[del] => 1
)</pre>
</div>
</div>
</div>
<div class="segmentedlist">
<strong class="title">Simple <span class="function"><strong>ob_get_status()</strong></span> results</strong>
<div class="seglistitem"><div class="seg"><strong><span class="segtitle">Key:</span></strong>level</div><div class="seg"><strong><span class="segtitle">Value:</span></strong>Output nesting level</div></div>
<div class="seglistitem"><div class="seg"><strong><span class="segtitle">Key:</span></strong>type</div><div class="seg"><strong><span class="segtitle">Value:</span></strong><em>PHP_OUTPUT_HANDLER_INTERNAL (0)</em> or <em>PHP_OUTPUT_HANDLER_USER (1)</em></div></div>
<div class="seglistitem"><div class="seg"><strong><span class="segtitle">Key:</span></strong>status</div><div class="seg"><strong><span class="segtitle">Value:</span></strong>One of <em>PHP_OUTPUT_HANDLER_START</em> (0), <em>PHP_OUTPUT_HANDLER_CONT</em> (1) or <em>PHP_OUTPUT_HANDLER_END</em> (2)</div></div>
<div class="seglistitem"><div class="seg"><strong><span class="segtitle">Key:</span></strong>name</div><div class="seg"><strong><span class="segtitle">Value:</span></strong>Name of active output handler or ' default output handler' if none is set</div></div>
<div class="seglistitem"><div class="seg"><strong><span class="segtitle">Key:</span></strong>del</div><div class="seg"><strong><span class="segtitle">Value:</span></strong>Erase-flag as set by <span class="function"><a href="function.ob-start.html" class="function">ob_start()</a></span></div></div>
</div>
</p>
<p class="para">
If called with <em><code class="parameter">full_status</code></em> = <strong><code>TRUE</code></strong> an array
with one element for each active output buffer level is returned.
The output level is used as key of the top level array and each array
element itself is another array holding status information
on one active output level.
<div class="informalexample">
<div class="example-contents screen">
<div class="cdata"><pre>
Array
(
[0] => Array
(
[chunk_size] => 0
[size] => 40960
[block_size] => 10240
[type] => 1
[status] => 0
[name] => default output handler
[del] => 1
)
[1] => Array
(
[chunk_size] => 0
[size] => 40960
[block_size] => 10240
[type] => 0
[buffer_size] => 0
[status] => 0
[name] => URL-Rewriter
[del] => 1
)
)
</pre></div>
</div>
</div>
</p>
<p class="para">
The full output contains these additional elements:
<div class="segmentedlist">
<strong class="title">Full <span class="function"><strong>ob_get_status()</strong></span> results</strong>
<div class="seglistitem"><div class="seg"><strong><span class="segtitle">Key:</span></strong>chunk_size</div><div class="seg"><strong><span class="segtitle">Value:</span></strong>Chunk size as set by <span class="function"><a href="function.ob-start.html" class="function">ob_start()</a></span></div></div>
<div class="seglistitem"><div class="seg"><strong><span class="segtitle">Key:</span></strong>size</div><div class="seg"><strong><span class="segtitle">Value:</span></strong>...</div></div>
<div class="seglistitem"><div class="seg"><strong><span class="segtitle">Key:</span></strong>blocksize</div><div class="seg"><strong><span class="segtitle">Value:</span></strong>...</div></div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.ob-get-status-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="function.ob-get-level.html" class="function" rel="rdfs-seeAlso">ob_get_level()</a> - Return the nesting level of the output buffering mechanism</span></li>
<li class="member"> <span class="function"><a href="function.ob-list-handlers.html" class="function" rel="rdfs-seeAlso">ob_list_handlers()</a> - List all output handlers in use</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.ob-get-level.html">ob_get_level</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.ob-gzhandler.html">ob_gzhandler</a></div>
<div class="up"><a href="ref.outcontrol.html">Output Control Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
