Перенос строки в PHP: \n, PHP_EOL и nl2br

Чтобы вывести новую строку, напишите \n внутри строки в двойных кавычках: echo "Line 1\nLine 2";. Константа PHP_EOL делает то же самое и в конце строки читается понятнее: echo 'Done' . PHP_EOL;. На веб-странице перенос строки не отображается как разрыв; там нужен <br> или nl2br().

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

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

Одинарные и двойные кавычки

Escape-последовательности вроде \n и \t работают только в двойных кавычках. В одинарных '\n' это два символа: обратный слеш и буква n. Это обычная причина того, что "\n не работает".

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

Все escape-последовательности, которые понимают двойные кавычки, перечислены на странице про строки.

PHP_EOL и "\n"

PHP_EOL это окончание строки той системы, на которой работает PHP: "\n" в Linux и macOS, "\r\n" в Windows. Используйте его для вывода в терминал и для файлов, которые будете читать на той же машине. Когда формат задаёт своё окончание строки, используйте его: HTTP-заголовкам и email нужен "\r\n", а большинство инструментов везде нормально читают "\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" это возврат каретки, "\n" перевод строки. Файлы Windows заканчивают строки обоими, "\r\n", поэтому текст от пользователя Windows или из <textarea> часто содержит неожиданные символы \r.

Новая строка в HTML: br и nl2br

Браузер сжимает переносы строк в один пробел, поэтому echo "a\nb" показывает на странице a b. Либо выводите <br> сами, либо оставьте переносы в тексте и преобразуйте их через nl2br(), которая вставляет <br /> перед каждым. Запустите и сравните вкладки Output и 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";

На вкладке Output все три варианта выглядят похоже. На вкладке Page первый сливается в одну строку, nl2br() разбивает его, а <pre> сохраняет переносы как написано.

Вывод текста из textarea с переносами

Текст из <textarea> сохраняет строки, которые ввёл пользователь, но перед выводом в HTML его нужно экранировать. Порядок важен: сначала htmlspecialchars(), потом nl2br(), иначе экранируются сами теги <br />. Запустите, введите несколько строк в поле и нажмите Preview: тот же скрипт выполнится снова с заполненным $_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; ?>

Перенос строки из textarea может прийти как "\r\n" или "\n"; в обоих есть "\n", поэтому подсчёт этого символа работает в любом случае. Почему экранирование здесь обязательно, объясняет htmlspecialchars().

Разбиение строки по переносу

explode("\n", $text) работает для текста, который вы создали сами. В тексте от пользователей или из файлов окончания строк могут быть "\r\n", "\n" или "\r"; preg_split('/\R/', $text) справляется со всеми, потому что \R совпадает с любым переносом строки.

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

Удаление переносов строк

Чтобы превратить многострочный текст в одну строку, замените все виды окончаний строк. Заменяйте "\r\n" раньше одиночных символов, иначе каждый перенос строки Windows превратится в два пробела:

<?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() и rtrim() удаляют переносы на концах строки, но никогда в середине, поэтому они подходят для строки, прочитанной из файла, и не подходят для склейки строк.