“Headers Already Sent” Hatası Nedir ve Nasıl Çözülür?

Web geliştirme yaparken “Headers Already Sent” hatasıyla karşılaşmak oldukça yaygındır. Bu hata, özellikle PHP gibi sunucu taraflı dillerde sıkça görülür ve genellikle HTTP başlıklarının, içerik gönderilmeden önce gönderilmesi gerektiği kuralının ihlali durumunda ortaya çıkar. Bu yazıda, “Headers Already Sent” hatasının ne olduğunu, neden oluştuğunu ve nasıl çözülebileceğini adım adım açıklıyoruz.

“Headers Already Sent” Hatası Nedir?

“Headers Already Sent” hatası, PHP’de bir HTTP başlığı gönderilmeye çalışıldığında, daha önce sayfaya herhangi bir içerik (HTML, boşluk, metin vb.) gönderilmişse ortaya çıkar. Bu durum, PHP’nin başlık bilgilerini bir kez gönderdikten sonra tekrar göndermeye çalışmasından kaynaklanır.

Örneğin:

echo "Merhaba Dünya!";
header("Location: /yeni-sayfa.php"); // Hata: Headers already sent

Bu durumda PHP, “Merhaba Dünya!” çıktısını gönderdikten sonra header() işleviyle bir yönlendirme yapmaya çalıştığı için hata verir.

“Headers Already Sent” Hatası Neden Oluşur?

1. Kodun Üstünde veya Altında Boşluklar:
   • PHP kodunun dışında, genellikle dosyanın başında veya sonunda fazladan bir boşluk veya satır bulunması bu hataya neden olabilir.
2. HTML İçeriği Gönderildikten Sonra Başlık Gönderme:
   • HTTP başlıkları, herhangi bir çıktıdan önce gönderilmelidir.
3. include/require Dosyalarında Çıktı Oluşması:
   • Dahil edilen dosyalardan gelen beklenmeyen çıktı (örneğin, echo veya boşluk).
4. Çıkış Tamponlama (Output Buffering) Sorunları:
   • Çıkış tamponlama devre dışı bırakılmışsa veya hatalı kullanılıyorsa bu hata oluşabilir.

“Headers Already Sent” Hatasını Nasıl Çözebilirsiniz?

1. Kodun Başındaki ve Sonundaki Boşlukları Temizleyin:
   • Dosyanızın başında ve sonunda boşluk veya fazladan satır olmadığından emin olun.
   • Örnek:

<?php
header("Location: /yeni-sayfa.php");
exit;
?>

2. Başlıklardan Önce Çıktı Göndermeyin:

Herhangi bir echo, print, HTML etiketi veya boşluk olmadan önce başlık işlemlerini gerçekleştirin.

Örnek:

header("Content-Type: application/json");
echo json_encode(["status" => "success"]);

3. include/require Dosyalarını Kontrol Edin:

Dahil edilen dosyalarda beklenmeyen bir çıktı olup olmadığını kontrol edin.

Örnek:

// include edilen dosya
<?php
// Fazladan boşluk yok!
return ['key' => 'value'];
?>

4. Çıkış Tamponlamayı Kullanın:

Çıkış tamponlama kullanarak, başlıklar gönderilmeden önce oluşan çıktıyı kontrol edebilirsiniz.

Örnek:

ob_start();
echo "Merhaba Dünya!";
header("Location: /yeni-sayfa.php");
ob_end_flush();

5. Hata Detayını Bulmak için error_reporting Kullanımı:

PHP’de hata raporlamayı etkinleştirerek sorunun nereden kaynaklandığını öğrenebilirsiniz.

Örnek:

ini_set('display_errors', 1);
error_reporting(E_ALL);

Örnek Çözüm

Hatalı Kod:

<?php
echo "Merhaba Dünya!";
header("Location: /yeni-sayfa.php"); // Hata verir
?>

Doğru Kod:

<?php
header("Location: /yeni-sayfa.php");
exit;
echo "Bu kod çalıştırılmaz."; // Bu kısım çalışmayacaktır
?>

“Headers Already Sent” hatası, genellikle kod düzenine dikkat ederek ve başlıkları doğru sırayla göndererek kolayca çözülebilir.

“Headers Already Sent” hataları, PHP’de sık karşılaşılan ama çözümü oldukça basit olan problemlerden biridir. Bu rehberde hatanın nedenlerini ve nasıl çözülebileceğini öğrendiniz. Kod yazarken başlıkların önce gönderilmesi gerektiğini unutmayın ve boşlukları kontrol edin. Eğer yazıyı faydalı bulduysanız, yorum yapmayı ve paylaşmayı unutmayın. 😊