So sieht die Meldung aus
PHP Warning: Cannot modify header information - headers already sent by (output started at /var/www/example.com/config.php:1) in /var/www/example.com/login.php on line 12Häufige Ursachen
- Ein UTF-8-BOM (versteckte Bytes) am Anfang einer PHP-Datei, oft von einem Editor gespeichert, meist in
config.phpoder einem Template. - Leerraum oder eine Leerzeile vor
<?phpoder nach einem schließenden?>in einer eingebundenen Datei. echo,printoder HTML-Ausgabe vorheader(),setcookie()odersession_start().- Eine PHP-Warnung oder -Notiz wird vor dem Header-Aufruf auf die Seite geschrieben (
display_errorsan) und löst dann diesen zweiten Fehler aus. - Ein Plugin oder Theme in einem CMS, das früh Ausgabe erzeugt.
Prüfen
- Die in der Meldung genannte Datei suchen und ihre ersten Bytes auf ein BOM prüfen
head -c 3 /var/www/example.com/config.php | xxd - PHP-Dateien nach einem BOM durchsuchen
grep -rl $'\xEF\xBB\xBF' --include='*.php' /var/www/example.com | head - Gibt es Ausgabe nach einem schließenden Tag am Dateiende?
tail -c 30 /var/www/example.com/config.php | xxd - Die Datei auf Syntaxprobleme prüfen
php -l /var/www/example.com/config.php
Lösung
- Die in der Meldung genannte Datei öffnen und alles vor
<?phpentfernen, auch das BOM (als UTF-8 ohne BOM speichern). - In Dateien, die nur PHP enthalten, das schließende
?>weglassen, damit kein nachfolgender Zeilenumbruch gesendet wird. header(),setcookie()undsession_start()vor jede Ausgabe verschieben oder so umbauen, dass die Ausgabe zuletzt kommt.- Ist eine frühere Warnung die erste Ausgabe, sie beheben oder in Produktion
display_errors = Offsetzen und stattdessen loggen. - Nur als Notlösung puffert
ob_start();am Anfang die Ausgabe, aber behebe die eigentliche Ursache.
Typisches Szenario
Du hast wp-config.php in einem Windows-Editor bearbeitet und als UTF-8 mit BOM gespeichert. Seitdem scheitern Login-Weiterleitungen in WordPress mit „Cannot modify header information – headers already sent by (output started at /var/www/html/wp-config.php:1)“. Die ersten drei unsichtbaren Bytes der Datei wurden schon als Ausgabe gesendet. Prüfe mit head -c 3 wp-config.php | xxd, ob dort efbbbf steht. Die Dateien, die als Erste in die Ausgabe schreiben, sind meist Konfigurationsdateien oder Includes, nicht die Seite selbst.
Häufige Fragen
Was heißt output started at config.php:1?
Das erste Byte wurde aus Zeile 1 dieser Datei gesendet. Das deutet auf ein BOM oder Leerraum vor dem öffnenden Tag.
Kann ich die Warnung bedenkenlos ignorieren?
Nein. Die Weiterleitung, das Cookie oder die Session, die hätte gesetzt werden sollen, geht verloren, Logins und Weiterleitungen können still scheitern.
Wie finde ich alle Dateien mit BOM in einem Projekt?
Mit grep -rl $'\xEF\xBB\xBF' --include='*.php' . listest du jede PHP-Datei auf, die mit dem BOM beginnt. Danach speicherst du sie im Editor als „UTF-8 ohne BOM“ neu. Moderne Editoren haben dafür eine Einstellung, die du dauerhaft aktivieren solltest.
Kann ich das Problem mit Output-Buffering umgehen?
Ja, mit output_buffering in der php.ini oder ob_start() am Anfang. Die Ausgabe wird dann gepuffert und Header gehen noch vor dem Body raus. Das verdeckt aber nur die Ursache; unsichtbare Zeichen bleiben im Code, und das Problem taucht bei anderer Konfiguration wieder auf.
Warum tritt es nur auf dem Server auf, aber nicht lokal?
Die Umgebungen unterscheiden sich oft in output_buffering. Ist die Pufferung lokal aktiv, fällt ein kurzes Stück Ausgabe nicht auf. Auf dem Server ist sie deaktiviert oder zu klein, und die Header sind sofort gesendet. Behebe deshalb die Datei, nicht die Konfiguration.