Nowa linia w PHP: \n, PHP_EOL i nl2br

Aby wypisać nową linię, napisz \n w stringu w podwójnych cudzysłowach: echo "Line 1\nLine 2";. Stała PHP_EOL robi to samo i czytelniej wygląda na końcu linii: echo 'Done' . PHP_EOL;. Na stronie WWW znak nowej linii nie pojawia się jako złamanie linii; tam potrzebujesz <br> albo nl2br().

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

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

Pojedyncze a podwójne cudzysłowy

Sekwencje ucieczki, takie jak \n i \t, działają tylko w podwójnych cudzysłowach. W pojedynczych '\n' to dwa znaki: ukośnik wsteczny i litera n. To zwykły powód, dla którego „\n nie działa”.

<?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;

Strona o stringach wymienia wszystkie sekwencje ucieczki rozumiane w podwójnych cudzysłowach.

PHP_EOL vs "\n"

PHP_EOL to znak końca linii systemu, na którym działa PHP: "\n" w Linuksie i macOS, "\r\n" w Windows. Używaj go dla wyjścia w terminalu i plików, które będziesz czytać na tej samej maszynie. Gdy format definiuje własny koniec linii, użyj właśnie jego: nagłówki HTTP i e-mail wymagają "\r\n", a większość narzędzi wszędzie dobrze czyta "\n".

<?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" to powrót karetki, a "\n" to wysunięcie wiersza. Pliki z Windows kończą linie oboma, "\r\n", dlatego tekst od użytkownika Windows albo z <textarea> często zawiera nieoczekiwane znaki \r.

Nowa linia w HTML: br i nl2br

Przeglądarka zamienia znaki nowej linii w pojedynczą spację, więc echo "a\nb" pokazuje na stronie a b. Albo wypisz <br> sam, albo zostaw znaki nowej linii w tekście i zamień je przez nl2br(), które wstawia <br /> przed każdym z nich. Uruchom to i porównaj zakładki Output i 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";

W zakładce Output wszystkie trzy wyglądają podobnie. W zakładce Page pierwszy zlewa się w jedną linię, nl2br() go łamie, a <pre> zachowuje znaki nowej linii tak, jak zostały zapisane.

Wyświetlanie danych z textarea razem z podziałem na linie

Tekst z <textarea> zachowuje linie wpisane przez użytkownika, ale przed wypisaniem do HTML trzeba go escapować. Kolejność ma znaczenie: najpierw htmlspecialchars(), potem nl2br(), inaczej escapowane zostałyby same znaczniki <br />. Uruchom, wpisz kilka linii w pole i naciśnij Preview: ten sam skrypt uruchomi się ponownie z wypełnionym $_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; ?>

Złamanie linii w textarea może przyjść jako "\r\n" albo "\n"; oba zawierają "\n", więc liczenie tego znaku działa w obu przypadkach. Strona htmlspecialchars() wyjaśnia, dlaczego escapowanie nie jest tu opcjonalne.

Podział stringa po znaku nowej linii

explode("\n", $text) działa dla tekstu, który sam utworzyłeś. W tekście od użytkowników lub z plików końce linii mogą być "\r\n", "\n" albo "\r"; preg_split('/\R/', $text) obsługuje je wszystkie, bo \R pasuje do każdego złamania linii.

<?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));

Usuwanie znaków końca linii ze stringa

Aby zamienić tekst wielolinijkowy w jedną linię, zamień każdy rodzaj końca linii. Zamieniaj "\r\n" przed pojedynczymi znakami, inaczej każde złamanie linii z Windows stałoby się dwiema spacjami:

<?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() i rtrim() usuwają znaki nowej linii na końcach stringa, ale nigdy w środku, więc są właściwym narzędziem dla linii odczytanej z pliku, a niewłaściwym do łączenia linii.