PHP Zeilenumbruch: \n, PHP_EOL und nl2br

Schreib \n in einen String in doppelten Anführungszeichen, um eine neue Zeile auszugeben: echo "Line 1\nLine 2";. Die Konstante PHP_EOL macht dasselbe und liest sich am Zeilenende klarer: echo 'Done' . PHP_EOL;. Auf einer Webseite erscheint ein Zeilenumbruch nicht als Umbruch; dort brauchst du <br> oder nl2br().

<?php
echo "Line 1\nLine 2\n";
echo 'Done' . PHP_EOL;

echo "Name:\tAda\n";      // \t is a tab
echo "Language:\tPHP\n";

Einfache vs doppelte Anführungszeichen

Escape-Sequenzen wie \n und \t funktionieren nur in doppelten Anführungszeichen. In einfachen ist '\n' zwei Zeichen: ein Backslash und der Buchstabe n. Das ist der übliche Grund für „\n funktioniert nicht“.

<?php
echo 'Single: one\ntwo', "\n";
echo "Double: one\ntwo", "\n";

echo strlen('\n'), "\n";  // 2 characters
echo strlen("\n"), "\n";  // 1 character

// Joining single-quoted text with a newline
echo 'one' . "\n" . 'two' . PHP_EOL;

Die Seite zu Strings listet jede Escape-Sequenz auf, die doppelte Anführungszeichen verstehen.

PHP_EOL vs "\n"

PHP_EOL ist das Zeilenende des Systems, auf dem PHP läuft: "\n" unter Linux und macOS, "\r\n" unter Windows. Verwende es für Terminalausgaben und Dateien, die du auf demselben Rechner liest. Wenn ein Format sein eigenes Zeilenende festlegt, verwendest du dieses: HTTP-Header und E-Mails brauchen "\r\n", und die meisten Werkzeuge lesen "\n" überall problemlos.

<?php
var_dump(PHP_EOL);
var_dump(PHP_EOL === "\n");

$lines = ['apples', 'pears', 'plums'];
file_put_contents('list.txt', implode(PHP_EOL, $lines) . PHP_EOL);

echo file_get_contents('list.txt');
echo "Lines in file: ", count(file('list.txt')), "\n";

"\r" ist ein Wagenrücklauf, "\n" ein Zeilenvorschub. Windows-Dateien beenden Zeilen mit beiden, "\r\n", und deshalb enthält Text von einem Windows-Nutzer oder aus einer <textarea> oft \r-Zeichen, mit denen du nicht gerechnet hast.

Neue Zeile in HTML: br und nl2br

Ein Browser fasst Zeilenumbrüche zu einem einzigen Leerzeichen zusammen, also zeigt echo "a\nb" auf einer Seite a b. Gib entweder selbst <br> aus oder behalte die Zeilenumbrüche im Text und wandle sie mit nl2br() um, das vor jedem ein <br /> einfügt. Führe das aus und vergleiche die Tabs Output und Page:

<?php
$address = "221B Baker Street\nLondon\nNW1 6XE";

echo "<p><strong>Raw newlines:</strong> ", $address, "</p>\n";
echo "<p><strong>With nl2br:</strong><br>", nl2br($address), "</p>\n";
echo "<p><strong>With pre:</strong></p><pre>", $address, "</pre>\n";

Im Tab Output sehen alle drei ähnlich aus. Im Tab Page läuft der erste Text in einer Zeile zusammen, nl2br() bricht ihn um, und <pre> behält die Zeilenumbrüche, wie sie geschrieben sind.

Textarea-Eingaben mit ihren Zeilenumbrüchen anzeigen

Text aus einer <textarea> behält die Zeilen, die der Nutzer getippt hat, aber du musst ihn escapen, bevor du ihn in HTML ausgibst. Die Reihenfolge zählt: zuerst htmlspecialchars(), dann nl2br(), sonst würden die <br />-Tags selbst escapt. Führe es aus, tippe ein paar Zeilen ins Feld und klicke auf Preview: Dasselbe Skript läuft erneut, mit gefülltem $_POST.

<?php
$note = $_POST['note'] ?? '';
?>
<form method="post">
    <textarea name="note" rows="4" cols="30"><?= htmlspecialchars($note) ?></textarea><br>
    <button>Preview</button>
</form>
<?php if ($note !== ''): ?>
    <h3>Preview</h3>
    <p><?= nl2br(htmlspecialchars($note)) ?></p>
    <p><?= substr_count($note, "\n") + 1 ?> lines</p>
<?php endif; ?>

Ein Zeilenumbruch aus einer Textarea kann als "\r\n" oder als "\n" ankommen; beide enthalten "\n", also funktioniert das Zählen dieses Zeichens in beiden Fällen. htmlspecialchars() erklärt, warum das Escapen hier nicht optional ist.

Einen String nach Zeilenumbruch aufteilen

explode("\n", $text) funktioniert für Text, den du selbst erzeugt hast. Bei Text von Nutzern oder aus Dateien können die Zeilenenden "\r\n", "\n" oder "\r" sein; preg_split('/\R/', $text) kommt mit allen zurecht, weil \R jeden Zeilenumbruch trifft.

<?php
$text = "first\r\nsecond\nthird\rfourth";

$lines = preg_split('/\R/', $text);
print_r($lines);

// explode leaves \r at the end of "first"
$naive = explode("\n", $text);
var_dump($naive[0]);

// Skip empty lines too
$text2 = "a\n\nb\n\n\nc\n";
print_r(preg_split('/\R/', $text2, -1, PREG_SPLIT_NO_EMPTY));

Zeilenumbrüche aus einem String entfernen

Um mehrzeiligen Text zu einer Zeile zu machen, ersetzt du jede Art von Zeilenende. Ersetze "\r\n" vor den einzelnen Zeichen, sonst würde jeder Windows-Zeilenumbruch zu zwei Leerzeichen:

<?php
$text = "Hello\r\nworld\nfrom\rPHP\n";

$oneLine = str_replace(["\r\n", "\r", "\n"], ' ', $text);
var_dump($oneLine);

$regex = preg_replace('/\R/', ' ', $text);
var_dump(trim($regex));

// Only the newline at the end
var_dump(rtrim("last line\n", "\r\n"));

trim() und rtrim() entfernen Zeilenumbrüche an den Enden eines Strings, aber nie in der Mitte, also sind sie das richtige Werkzeug für eine Zeile aus einer Datei und das falsche, um Zeilen zu verbinden.