15.4.2 Reading queued headers: headers_list()This is NOT the latest copy of this book; click here for the latest version.
array headers_list ( void )
We already looked at the headers_sent() function, which tells us whether or not HTTP headers have already been sent to the client. This function duplicates that functionality, but, crucially, also returns headers that have yet to be sent, which when you think about it is a bit more useful.
As you can see from the prototype, it takes no parameters, and returns an array. That array contains a numerically indexed list of the headers that are ready for sending, which means we can extend our previous example like this:
<?php
header("Expires: Sat, 22 Dec 1979 05:30:00 GMT");
echo "This is some text for output.<BR />";
if (!headers_sent($filename, $linenum)) {
// if no headers have been sent, send one
// this will not execute, as we sent the Expires header.
header("Location: www.yoursite.com");
exit;
} else {
echo "Headers already sent in $filename on line $linenum.<BR />";
echo "Headers sent are:<BR /> <UL>";
$headers = headers_list();
foreach($headers as $header) {
echo "<LI>$header</LI>";
}
echo "</UL>";
exit;
} ?>
Author's Note: This function was broken at the time of writing. Please check the PHP bug database (http://bugs.php.net/29683) for an update.
|
Want to see this stuff in print? PHP in a Nutshell takes the core topics covered here, adds in thousands of edits from the editorial team and myself, and combines them to make an unbeatable reference for PHP programmers at all levels.
My latest book has hundreds more tips on how to use PHP, Apache, and MySQL, plus Perl, Python, shell scripts, performance tuning, and more!
|