Hudzilla.org - the homepage of Paul Hudson
Contents > Networks > HTTP Wish List | Report Bug | About Me ]

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.





<< 15.4.1 Sending custom headers: header() and headers_sent()   15.4.3 Authentication over HTTP >>
Table of Contents
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!



Top-right shadow
 
Bottom-left shadow Bottom shadow

Comments from other readers
Be the first to add a comment to this chapter!



Add comment
Please note that by posting a comment here you are committing it to the public domain. This is important so that others can make use of your code themselves, and also so that I can incorporate helpful notes directly into the main text. Comments are limited to 2000 characters in length.

If you are reporting an error in the content, please tell me directly.

Your name/email address:
Your comment:
 
Now, in order to verify that you're a real person, please answer this simple question: what is ten plus five?
The answer is:
(please write in
numbers, eg 19)


Top-right shadow
 
Bottom-left shadow Bottom shadow