PHP echo перенос строки: способы для браузера и консоли

В PHP при выводе через echo способ переноса строки зависит от среды вывода. В браузере используйте <br />, nl2br() или CSS, а в консоли и файлах – "\n" либо PHP_EOL. Каждый пример показывает код и результат для нужной среды.

Как сделать перенос строки в echo

Сначала определите, где появится текст. HTML обрабатывает разметку, а терминал и файл сохраняют символы перевода строки.

Где выводимСпособЧто получится
Браузер<br />Новая строка на странице
Браузер, текст формы или базыhtmlspecialchars() и nl2br()Безопасные переносы в тексте
Консоль"\n" или PHP_EOLСледующая строка терминала
Файл"\n", "\r\n" или PHP_EOLСледующая строка файла
<?php
echo 'Первая строка<br />';
echo 'Вторая строка';
?>

Результат. Браузер покажет две строки. В исходнике страницы будет последовательность Первая строка<br />Вторая строка. В CLI терминал напечатает сам тег <br />.

echo и print: синтаксис и отличия

echo – языковая конструкция PHP. Она принимает несколько аргументов через запятую без скобок. print принимает один аргумент и возвращает значение 1.

<?php
echo 'Имя: ', 'Анна', "\n";
print 'Готово';
$result = print "\nСледующая строка";
?>

Результат. CLI выведет «Имя: Анна», затем «Готово» и «Следующая строка». Переменная $result получит значение 1. Синтаксис описан в документации PHP для echo и в разделе о print.

<?php
echo ('A');

// Эта строка оставлена комментарием, потому что она вызвала бы ошибку:
// echo ('A', 'B');

echo 'A' . 'B';
?>

Результат. Рабочая программа напечатает AAB. Скобки группируют одно выражение, но не превращают echo в вызов с несколькими аргументами.

В PHP-шаблоне короткий тег <?= ?> сразу выводит выражение. PHP поддерживает этот тег начиная с версии 5.4.

<?php $name = 'Анна'; ?>
<p>Здравствуйте, <?= htmlspecialchars($name, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8') ?>!</p>

Результат. Браузер покажет «Здравствуйте, Анна!». В исходнике страницы появится готовый абзац без PHP-кода.

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

Двойные кавычки обрабатывают управляющие последовательности и подставляют переменные. Одинарные кавычки сохраняют почти весь текст без изменений.

<?php
echo "Первая строка\nВторая строка";
echo '\n';
?>

Результат. Первая команда разделит текст на две строки в CLI. Вторая команда напечатает буквальные символы \n в конце строки «Вторая строка».

Точку используйте для соединения текста и значения переменной. Фигурные скобки помогают вставлять элемент массива внутрь двойной строки.

<?php
$name = 'Анна';
$user = ['name' => 'Анна'];
echo "Имя: $name\n";
echo 'Имя: ' . $name . "\n";
echo "Пользователь: {$user['name']}\n";
?>

Результат. CLI напечатает три строки: «Имя: Анна», «Имя: Анна» и «Пользователь: Анна». Правила строк описаны в документации PHP о строках.

PHP перевод строки в консоли и файлах

В PHP перевод строки в CLI обеспечивает "\n" или PHP_EOL. Константа выбирает разделитель строк для операционной системы, где запущен PHP.

<?php
echo "Строка один\n";
echo 'Строка два' . PHP_EOL;
?>

Результат. Консоль покажет «Строка один» и «Строка два» на отдельных строках. PHP_EOL подставит системный конец строки. Описание константы есть в документации PHP о предопределенных константах.

Windows использует последовательность \r\n. Для текста, который читают в разных системах, задайте разделитель явно.

<?php
$lines = ['Первая запись', 'Вторая запись'];
file_put_contents('report.txt', implode(PHP_EOL, $lines) . PHP_EOL);
?>

Результат. PHP запишет в report.txt две записи на отдельных строках. Последний PHP_EOL завершит последнюю запись. Код ничего не выведет в браузер и консоль. Для сохранения результата пригодятся приёмы работы с файлами в PHP.

<?php
file_put_contents('windows.txt', "Первая строка\r\nВторая строка\r\n");
?>

Результат. Файл получит две строки с явным разделителем \r\n. Такой вариант подходит формату, которому нужны Windows-окончания.

Перенос строки в браузере

HTML схлопывает обычные пробелы и переводы строк. Поэтому символ \n попадет в исходник страницы, но сам по себе не создаст видимый разрыв.

<?php
echo "Первая строка\nВторая строка";
?>

Результат. Браузер покажет «Первая строка Вторая строка». В исходнике страницы между словами останется настоящий перевод строки.

Для собственной HTML-разметки добавьте <br /> в строку.

<?php
echo "Первая строка<br />Вторая строка";
?>

Результат. Браузер покажет две строки. В исходнике страницы будет тег <br />.

Пользовательский текст сначала экранируйте, затем передавайте в nl2br(). Так введенные HTML-теги останутся текстом, а переносы превратятся в разрывы.

<?php
$text = "Первая строка\nВторая строка <strong>текст</strong>";
$safeText = htmlspecialchars($text, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
echo nl2br($safeText, true);
?>

Результат. На странице появятся две строки. Фрагмент <strong>текст</strong> отобразится обычным текстом. В исходнике перед второй строкой появится <br />, а угловые скобки станут HTML-сущностями.

nl2br() вставляет HTML-разрыв перед символом перевода и сохраняет сам перевод. Параметр use_xhtml со значением true дает <br />, а значение false дает <br>. Подробности приведены в документации nl2br().

<?php
$text = "Первая строка\nВторая строка";
echo '<p class="multiline">' . htmlspecialchars($text, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8') . '</p>';
?>

<style>
.multiline { white-space: pre-line; }
</style>

Результат. Браузер покажет две строки благодаря CSS-свойству white-space: pre-line. В исходнике останется перевод строки без добавленного тега <br>.

<?php
$text = "Первая строка\n    Строка с отступом";
echo '<pre>' . htmlspecialchars($text, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8') . '</pre>';
?>

Результат. Браузер покажет две строки и четыре пробела перед второй. Элемент <pre> сохраняет переводы и пробелы.

Многострочный вывод через heredoc и nowdoc

Берите heredoc для HTML-шаблона с переменными. Nowdoc сохраняет буквальный текст, поэтому $name и \n остаются символами.

<?php
$name = 'Анна';
$safeName = htmlspecialchars($name, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
$html = <<<HTML
<p>Здравствуйте, {$safeName}!</p>
<p>Ваш заказ готов.</p>
HTML;
echo $html;
?>

Результат. Браузер покажет два HTML-абзаца с именем Анна. В исходнике страницы будут два тега <p>. Значение имени прошло через htmlspecialchars().

С PHP 7.3 закрывающий идентификатор heredoc или nowdoc может иметь отступ. PHP удаляет общий отступ из содержимого строки. Отступ маркера не должен быть глубже отступа любой непустой строки.

<?php
$name = 'Анна';
$safeName = htmlspecialchars($name, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
$html = <<<HTML
    <p>Здравствуйте, {$safeName}!</p>
    <p>Заказ готов.</p>
    HTML;
echo $html;
?>

Результат. PHP уберет общий отступ. Браузер покажет два абзаца, а исходник начнется с <p> без четырех пробелов.

<?php
$text = <<<'TEXT'
Имя: $name
Последовательность \n остается текстом.
TEXT;
echo nl2br(htmlspecialchars($text, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'));
?>

Результат. Браузер покажет $name и символы \n как текст. Перевод между строками появится благодаря nl2br(), а специальные символы останутся безопасными.

Закрывающий маркер должен совпадать с открывающим, включая регистр. Он начинается с новой строки после допустимого отступа.

Ошибки при выводе переносов строк в PHP

Сопоставьте разделитель с окружением и форматом ответа. Так вы избежите лишних тегов и буквальных символов.

  • '\n' в одинарных кавычках. PHP выведет два символа \n. Возьмите "\n" или присоедините перенос оператором ..
  • <br /> в CLI. Терминал покажет HTML-тег. Используйте PHP_EOL или "\n".
  • nl2br() без экранирования. Пользовательский HTML попадет на страницу и создаст риск XSS. Сначала вызовите htmlspecialchars(), затем nl2br().
  • \n в JSON-ответе. JSON хранит перенос внутри строкового значения как escape-последовательность. API не должен получать HTML-тег вместо символа переноса.
  • Несколько аргументов в скобках echo. Запись echo ('A', 'B'); вызывает синтаксическую ошибку. Уберите скобки или соедините значения точкой.
<?php
$payload = ['message' => "Первая строка\nВторая строка"];
echo json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
?>

Результат. CLI получит JSON со строковым значением, где перенос представлен escape-последовательностью \n. Клиент восстановит перевод после разбора JSON. В обычном HTML браузер снова схлопнет такой перенос в пробел.

Для браузера берите <br />, nl2br() или CSS. Пользовательский текст сначала пропускайте через htmlspecialchars(). Для CLI и файлов подходят PHP_EOL и "\n", а фиксированный Windows-разделитель задавайте как "\r\n".

Комментарии

Оставьте свой комментарий
Пока никто не оставил комментариев