headers_sent

(PHP 4, PHP 5, PHP 7, PHP 8)

headers_sentBaşlıklar gönderilmiş mi, gönderilmişse nerede gönderilmiş diye bakar

Açıklama

headers_sent(string &$dosya = null, int &$satır = null): bool

Başlıklar gönderilmiş mi, gönderilmişse nerede gönderilmiş diye bakar.

Tüm başlıklar gönderildikten sonra header() işlevini kullanarak daha fazla başlık satırı ekleyemezsiniz. Bu işlevi kullanarak HTTP başlıklarıyla ilgili hata iletilerinden en azından bazılarını engelleyebilirsiniz. Diğer bir seçenek de Çıktı Tamponlaması kullanmaktır.

Bağımsız Değişkenler

dosya

İsteğe bağlı dosya ve satır bağımsız değişkenleri kullanılırsa, headers_sent() işlevi çıktının başlatılacağı PHP kaynak dosyası ismi ve satır numarasını dosya ve satır bağımsız değişkenlerine yerleştirir.

Bilginize:

PHP kaynak kodu çalıştırılmadan çıktılama başlamışsa (örneğin bir başlatma hatasından dolayı) bu bağımsız değişkene boş dizge atanır.

satır

Çıktının başlatılacağı satır numarası.

Dönen Değerler

Henüz hiçbir başlık gönderilmemişse headers_sent() işlevi false ile döner, aksi takdirde true döndürür.

Örnekler

Örnek 1 - headers_sent() kullanım örnekleri

<?php

// Henüz hiçbir başlık gönderilmemişse bir tane gönder
if (!headers_sent()) {
header('Location: http://mesela.dom/');
exit;
}

// Seçimlik dosya ve satır kullanımı örneği.
// $dosya ve $satır bağımsız değişkenlerinin daha sonra kullanılmak üzere
// aktarıldığına dikkat edin. Bunlara bir değer atamayın.
if (!headers_sent($dosya, $satır)) {
header('Location: http://mesela.dom/');
exit;

// Çoğunlukla burada bir hata alırsınız.
} else {

echo
"Başlıklar $dosya dosyasının $satır. satırında gönderilmiş.\n" .
"Yönlendirme yapılamıyor, şimdilik <a " .
"href=\"http://mesela.dom\">buraya tıklayınız</a>\n";
exit;
}

?>

Notlar

Bilginize:

Başlıklar sadece onları destekleyen bir SAPI kullanımdaysa erişilebilir ve çıktılanabilir olacaktır.

Ayrıca Bakınız

  • ob_start() - Çıktı tamponlamasını başlatır
  • trigger_error() - Kullanıcı seviyesinde bir hata/uyarı/bilgi iletisi üretir
  • headers_list() - Gönderilmiş (veya gönderilmeye hazır) yanıt başlıklarının listesiyle döner
  • Bu konuda daha ayrıntılı bilgi edinmek için header() - Ham bir HTTP başlığı gönderir belgesine bakınız.

add a note

User Contributed Notes 7 notes

up
14
yesmarklapointe at hotmail dot com
16 years ago
I was having trouble getting my mind around the concepts involved. Here is my dilemma and the conclusion I reached in case recounting them can help others:I am using WAMPserver: PHP 5.2.6, and Apache 2.2.8 on Windows XP SP3. If it matters to your duplication, I found two php.ini files in WAMPserver where output_buffering had been set to 4096. I changed them to OFF for this testing. Here is how you can replicate what I am experiencing: With IE 7.0 go to Tools ... Display ieHTTPheaders ... and run the following script repeatedly and watch what happens:<?phpheader( 'Expires: Mon, 26 Jul 1998 05:00:00 GMT' );//var_dump(headers_sent());//print("whatever");//flush();//echo "whatever";var_dump(headers_sent());?>Result: the final var_dump of the headers_sent() function will always return FALSE unless any one or  more of the commented lines above it are uncommented. Uncommenting the statements allows an output to be sent to the user not just to their browser, after which the final var_dump will return TRUE. What I found confusing was that the ieHTTPheaders tool shows that the header is being sent to the user's browser even when all the output lines are commented out. So why does headers_sent() return FALSE in this case? Because you can keep sending other headers. The headers_sent function is meant to alert one to when no further headers can be sent. My testing shows it does not return true unless some other output is also sent after the header, thereby signaling that  "Headers have been sent and concluded with user output. NOW you can't send any more headers."Someone else worked his way through this problem in a (false) bug report: http://bugs.php.net/bug.php?id=30264Here is the relevant part of the reply from the pro:"When you use compression the entire page is buffered in memory, until end of the request. Consequently you can send headers at any time because no data is being actually sent to user when you print it. Until PHP actually decides to send any page output to the user you can still send additional headers which is why the headers_sent() function is returning false. It will return true, indicating that headers have been sent  only at a time when output began going to the user and you no longer can send any additional headers."So in summary, my point is that there is a difference between headers being sent only to the browser (which can be followed by other headers) vs. headers being sent and concluded by output for the user. The function should have been given a more clear name like headers_concluded().
up
23
Jakob B.
19 years ago
<?phpfunction redirect($filename) {    if (!headers_sent())        header('Location: '.$filename);    else {        echo '<script type="text/javascript">';        echo 'window.location.href="'.$filename.'";';        echo '</script>';        echo '<noscript>';        echo '<meta http-equiv="refresh" content="0;url='.$filename.'" />';        echo '</noscript>';    }}redirect('http://www.google.com');?>
up
2
php at fufachew dot REMOVEME dot com
21 years ago
RE: antti at haapakangas dot net's postI've changed the code so $_SERVER['SERVER_NAME'] is used if $_SERVER['HTTP_HOST'] is not set.  $_SERVER['SERVER_NAME'] doesn't meet my needs, but I suppose it's good to fall back on it.  I've also fixed a problem in the meta refresh line - it was missing the "url=" part of the content attribute.<?phpfunction server_url(){       $proto = "http" .        ((isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] == "on") ? "s" : "") . "://";    $server = isset($_SERVER['HTTP_HOST']) ?        $_SERVER['HTTP_HOST'] : $_SERVER['SERVER_NAME'];    return $proto . $server;}    function redirect_rel($relative_url){    $url = server_url() . dirname($_SERVER['PHP_SELF']) . "/" . $relative_url;    if (!headers_sent())    {        header("Location: $url");    }    else    {        echo "<meta http-equiv=\"refresh\" content=\"0;url=$url\">\r\n";    }}?>
up
2
trevize (shtrudel) gmail.com
19 years ago
Note that in IIS (or at least the version that comes with W2K server), the server seems to do some buffering, so even if you output someting or cause a warning, the value of headers_sent() may be false because the headers haven't been sent yet.So it's not a safe way to know if warnings have been encountered in your script.
up
2
collectours at free dot fr
18 years ago
In response to K.Tomono and alexrussell101 at gmail dot com :Yes,headers_sent() will return false, even if you sent something to the ouptut using print() or header() , if output_buffering is different from Off in you php.ini, and the length of what you sent does not exceed the size of output_buffering.To test it, try this code with  these values in php.ini1) output_buffering=322) output buffering = 4096[code]<?php    echo "Yo<br />";    echo "Sent:",headers_sent(),"<br />";    echo "enough text to feed the buffer until it overflows ;-)<br />";    echo "Sent:",headers_sent(),"<br />";?>[/code]then put 3) output buffering = Offand try this code[code]<?php    echo "Yo<br />";    echo "Sent:",headers_sent(),"<br />";?>[/code]which will this time unconditionnally say that headers were sent.This is noticed in php.ini comment :"Output buffering allows you to send header lines (including cookies) even after you send body content, in the price of slowing PHP's output layer a bit."Note : This is completly independant of implicit_flush tuning.
up
0
rojasredes at gmail dot com
7 years ago
Remember to save source code file *.php with UTF-8 without BOM.If saved with UTF-8 BOM the next code allways return "true":<?phpif headers_sent($source,$numline){       die("true");}else{    die("false");}?>Even when $numline is 1, and there is any character before <?phpand after ?>Save file without BOM and everything will be ok, then.
up
0
Jase
16 years ago
This is becoming annoying the amount of posts to try and describe the behaviour of headersHeaders appear first in the data sent to the user's browserif headers have been called using the header() function but no data has been sent to the output buffer (using echo, readfile etc), then the headers are sent at the end of script execution otherwise they are sent when the buffer reaches it's limit and emptiedsimplethis means that headers_sent() will return false if nothing is sent to the output buffer because the headers are being sent at the end of the scriptThis is not a bug either, this is expected behaviour. Keeping headers until forced to send them out is a good idea because certain measures can be taken like prevention of meta injection etc (option in header() to replace headers that have not yet been sent)besides, headers_sent() is good for when you try and send headers but the output buffer has already been emptied (in cases of php error handling for example). Obviously if the buffer has emtpied, sending headers won't work.
To Top