Błąd "Warning: Cannot add header information - headers already sent..."

Błąd (a właściwie ostrzeżenie) Warning: Cannot add header information - headers already sent by ... pojawia się przy używaniu sesji, ciastek czy funkcji header. Spowodowany jest tym, że sesje, ciasteczka oraz funkcja header operują na nagłówkach protokołu HTTP, które muszą być wysłane przez serwer przed danymi, a że PHP jest wykonywany liniowo (wraz z wysyłaniem danych) to błąd pojawia się, gdy próbujemy wysłać nagłówek już po wysłaniu jakichkolwiek danych.

Rozwiązania:

1. Wysyłanie danych należy dać na samym początku skryptu (przed wysłaniem jakichkolwiek danych funkcją echo, print itp.),
2. Spokojnie można używać normalnie tych funkcji, jeżeli używamy systemu szablonów w rodzaju Smarty, które wysyłają dane do przeglądarki dopiero na koniec działania skryptu (o ile został prawidłowo napisany),
3. Na sam początek strony (przed jakimikolwiek danymi!) trzeba wywołać funkcję ob_start(); a na koniec ob_end_flush();. Teoretycznie powoduje to niewielkie opóźnienie w działaniu skryptu, ale w większości sytuacji jest ono niemierzalne. Działa to na zasadzie buforowania zawartości, która nie jest na bieżąco wyświetlana, a dopiero po zakończeniu działania skryptu.

Ale ja nic nie wysyłałem!

Może zdarzyć się sytuacja, gdy programista twierdzi, że on nie wysyła niczego, a i tak błąd się pojawia. Należy wtedy zwrócić szczególną uwagę na puste linie bądź inne białe znaki przed znacznikiem rozpoczynającym (<?php) oraz po kończącym skrypt (jeżeli ten jest włączany do innego) oraz - jeżeli używa się kodowania UTF-8 - na tak zwany BOM (Byte Order Mark).

Byte Order Mark to trzy bajty na początku pliku zakodowanego w standardzie UTF-8, które właśnie identyfikują to kodowanie - jeżeli takie znajdą się przed znacznikiem rozpoczynającym PHP to oczywiście zostaną wysłane i nie będzie można wysłać żadnych dodatkowych nagłówków. Niektóre aplikacje (np. Notatnik albo Microsoft Expression Web) umieszczają w tworzonych przez siebie plikach znacznik BOM - należy zwrócić na to uwagę.

Przykłady

Przykładowa sytuacja w której interpreter PHP zwróci błąd:

<?php
echo '<?xml version="1.0"?>';
echo '<foo>Error!</foo>';
header('404 Not Found');