HOWTO · PHP

Wie man eine neue Zeile in PHP erstellt

So wählen Sie in PHP den passenden Zeilenumbruch: `\n` für Text, `PHP_EOL` für plattformnative Dateien und `<br>` für HTML.

Auf dieser Seite

Um einen Zeilenumbruch in PHP zu erzeugen, wählen Sie die Darstellung danach aus, wo die Ausgabe gelesen wird. Verwenden Sie \n in einer Zeichenkette mit doppelten Anführungszeichen für einen Zeilenumbruch in Text und PHP_EOL, wenn der Text das native Zeilenende der aktuellen Plattform verwenden soll. Für einen sichtbaren Umbruch im Browser geben Sie HTML wie <br> aus; ein Zeilenumbruch im HTML-Quelltext allein erzeugt normalerweise keinen sichtbaren Umbruch. Diese Möglichkeiten sind nicht austauschbar: Ein Browser verarbeitet HTML, während ein Terminal oder ein Textdatei-Reader Zeichen liest.

Den Zeilenumbruch passend zum Ausgabeformat wählen

Verwenden Sie für CLI-Meldungen, Protokolle und reine Textdateien ein Zeilenumbruchzeichen in der Zeichenkette oder PHP_EOL, wenn die Datei der Plattformkonvention folgen soll. Für HTML-Antworten verwenden Sie Markup, das der Browser versteht. Entscheidend ist, wer die Ausgabe liest, und nicht allein das Betriebssystem, auf dem PHP läuft. Wenn die Ausgabe sowohl als Text als auch als HTML gelesen werden könnte, erstellen Sie getrennte Formate für die jeweiligen Leser, statt Markup und Textzeilenenden in einer Zeichenkette zu vermischen.

\n in einer PHP-Zeichenkette verwenden

In einer PHP-Zeichenkette mit doppelten Anführungszeichen steht \n für einen Zeilenvorschub. Eine Zeichenkette mit einfachen Anführungszeichen interpretiert \n nicht als Zeilenumbruch, sondern behält die Backslash-Sequenz bei (unter Beachtung der begrenzten Escape-Regeln für einfache Anführungszeichen in PHP). Verwenden Sie doppelte Anführungszeichen, wenn PHP diese Escape-Sequenz interpretieren soll. Zwei aufeinanderfolgende Zeilenvorschübe lassen eine Leerzeile zwischen den Textzeilen entstehen.

Führen Sie dieses Beispiel aus. Der Code und die darin ausgegebenen Beispieltexte sind unverändert; die angezeigten Texte bleiben daher auf Englisch:

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

<?php
$message = "Hello, PHP!\nWelcome back.";
echo $message, "\n";
?>

Erwartete Ausgabe:

Hello, PHP!
Welcome back.

Das eignet sich für die Ausgabe im Terminal und für Textinhalte. Beim Schreiben einer Datei werden die Bytes der Zeichenkette unverändert geschrieben. Wählen Sie daher die Zeilenendekonvention, die das Programm erwartet, das die Datei später liest.

PHP_EOL für plattformnativen Text verwenden

PHP_EOL enthält die Zeilenendesequenz der Plattform, auf der PHP ausgeführt wird. Verketten Sie sie zwischen Textzeilen, zum Beispiel mit "First" . PHP_EOL . "Second". Das ist nützlich für CLI-Ausgaben und Textdateien, die für diese Umgebung bestimmt sind. Es erzeugt keinen sichtbaren HTML-Umbruch: Beim Darstellen eines Absatzes kann der Browser Leerraum im Quelltext zusammenfassen. Auch kann eine Datei für ein bestimmtes Austauschformat ein festgelegtes Zeilenende erfordern. Verwenden Sie dann die vorgeschriebenen Zeichen dieses Formats, statt anzunehmen, dass die Host-Plattform die richtige Wahl ist.

<br> für HTML-Zeilenumbrüche verwenden

Beim Erzeugen von HTML ist <br> ein HTML-Element für einen Zeilenumbruch. PHP kann zum Beispiel "First line<br>Second line" ausgeben; ein HTML-Renderer zeigt den Text dann in getrennten Zeilen an. Ein Zeilenumbruchzeichen im HTML-Quelltext wird im Allgemeinen als Leerraum behandelt und garantiert keinen sichtbaren Umbruch. Umgekehrt erscheint <br> im Terminal als wörtliches Markup und bewegt den Cursor nicht in eine neue Zeile. Escapen Sie nicht vertrauenswürdige Werte, bevor Sie sie in HTML einfügen; das Zeilenumbruchelement macht den umgebenden Inhalt nicht sicher.

\r\n und Leerzeilen verstehen

\r\n besteht aus einem Wagenrücklauf, gefolgt von einem Zeilenvorschub. Diese Sequenz ist das übliche Zeilenende in vielen Windows-Textdateien. In einer PHP-Zeichenkette mit doppelten Anführungszeichen ergeben die beiden Escape-Sequenzen diese zwei Steuerzeichen. Verwenden Sie die Sequenz, wenn ein Zielformat ausdrücklich CRLF erwartet. Andernfalls ist PHP_EOL für plattformnativen Text praktisch, während \n in Formaten üblich ist, die einen Zeilenvorschub festlegen. Eine Leerzeile entsteht durch eine weitere vollständige Zeilenendesequenz, etwa in "First\n\nSecond". Der Wagenrücklauf ist keine PHP-Anweisung, die einen Ausgabezeiger zurücksetzt, sondern ein Zeichen, dessen Anzeigeeffekt vom Ausgabegerät abhängt.

Häufige Fehler und schnelle Prüfungen

  • Wenn \n wörtlich erscheint, prüfen Sie, ob die Zeichenkette einfache Anführungszeichen verwendet. Verwenden Sie doppelte Anführungszeichen oder erzeugen Sie den Zeilenumbruch auf andere Weise.
  • Wenn ein Browser den Text in einer einzigen sichtbaren Zeile anzeigt, prüfen Sie das dargestellte HTML. Verwenden Sie <br> oder geeignetes CSS, statt sich auf Leerraum im Quelltext zu verlassen.
  • Wenn <br> in einem Terminal oder einer gespeicherten Textdatei erscheint, wird die Ausgabe als Text verarbeitet. Verwenden Sie stattdessen \n oder PHP_EOL.
  • Wenn ein anderes Programm eine Textdatei ablehnt, prüfen Sie die dafür vorgeschriebene Zeilenendekonvention. \n, \r\n und PHP_EOL können unterschiedliche Bytefolgen erzeugen.

Wählen Sie die Darstellung passend dazu, wer die Ausgabe als Nächstes liest: PHP-Zeichenkettensyntax für Textzeilenvorschübe, PHP_EOL für native Textdateien, die vorgeschriebene Sequenz für ein festgelegtes Dateiformat und <br> für HTML, das im Browser dargestellt wird.