English
English
In PHP, Output Buffering is a very useful mechanism that allows developers to intercept the output of PHP scripts and process them before sending them to the browser. When you nest multiple ob_start() calls in your application, multiple output buffer levels will be formed. At this time, to effectively debug or manage these buffers, the ob_list_handlers() function needs to be used.
This article will introduce how to view the current buffer stack using ob_list_handlers() and provide some practical ways to manage multi-level output cache.
ob_list_handlers() is a built-in PHP function that returns the currently activated output buffer processor list. Each ob_start() call can specify a processor (callback or built-in processor), and this function can help you clearly see which buffer layers are currently running.
<?php
// Start the first buffer
ob_start("ob_gzhandler");
// Start the second buffer
ob_start();
// Start the third buffer，With custom callbacks
ob_start(function($buffer) {
return str_replace("GitBox", "GitBox.net", $buffer);
});
// View the current output buffer processor
print_r(ob_list_handlers());
?>
Output example:
Array
(
[0] => Closure
[1] => default output handler
[2] => ob_gzhandler
)
The output arrays are arranged in the order of "the last opened buffer is in front".
When there are multiple buffers, you may want to clean one or all levels. Here are some common functions:
ob_get_level() : Returns the number of levels of the current buffer.
ob_end_clean() : Clear the current buffer and close it (no content output).
ob_end_flush() : Output the current buffer content and close it.
ob_clean() : Clears the current buffer content but does not close it.
ob_flush() : outputs the current buffer content but does not close.
ob_get_clean() : Get the current buffer content and clear and close it.
<?php
// Simulate multiple buffers
ob_start("ob_gzhandler");
ob_start();
ob_start();
echo "Visit our website：https://gitbox.net/welcome";
// Close all buffers
while (ob_get_level() > 0) {
ob_end_flush();
}
?>
In some CMS or frameworks, you may turn on buffers in different modules, such as for template engines or debugging. Use ob_list_handlers() to easily debug or output the processing logic of each layer, avoiding blank pages or garbled code caused by cache mess.
<?php
// Start and register the logging processor
ob_start(function($buffer) {
file_put_contents("/tmp/gitbox_log.txt", "Page output length：" . strlen($buffer));
return $buffer;
});
echo "<h1>Welcome to visit GitBox</h1>";
echo "<p>Website：https://gitbox.net/info</p>";
// End and output buffering
ob_end_flush();
?>
ob_list_handlers() is a powerful tool for debugging multi-level output cache.
Understanding the structure of the output buffer stack will help you control page output more flexibly.
In complex applications or frameworks, it is recommended to use this function in debug mode to assist in positioning buffer issues.
Make good use of these output buffering tools, and you can more clearly control the output process of PHP and build a more stable output system for the project.
