Quebra de linha no PHP: \n, PHP_EOL e nl2br

Escreva \n dentro de uma string entre aspas duplas para imprimir uma nova linha: echo "Line 1\nLine 2";. A constante PHP_EOL faz o mesmo e fica mais legível no fim de uma linha: echo 'Done' . PHP_EOL;. Numa página web, uma quebra de linha não aparece como quebra; ali você precisa de <br> ou nl2br().

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

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

Aspas simples ou aspas duplas

Sequências de escape como \n e \t só funcionam entre aspas duplas. Entre aspas simples, '\n' são dois caracteres: uma barra invertida e a letra n. Esse é o motivo comum de "o \n não funciona".

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

A página sobre strings lista todas as sequências de escape que as aspas duplas entendem.

PHP_EOL ou "\n"

PHP_EOL é o fim de linha do sistema em que o PHP está rodando: "\n" no Linux e no macOS, "\r\n" no Windows. Use para saída no terminal e arquivos que você vai ler na mesma máquina. Quando um formato define o próprio fim de linha, use o dele: cabeçalhos HTTP e e-mail precisam de "\r\n", e a maioria das ferramentas lê "\n" sem problema em qualquer lugar.

<?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" é um retorno de carro, "\n" uma alimentação de linha. Arquivos do Windows terminam as linhas com os dois, "\r\n", e é por isso que texto de um usuário do Windows ou de um <textarea> muitas vezes contém caracteres \r inesperados.

Nova linha no HTML: br e nl2br

Um navegador junta as quebras de linha num único espaço, então echo "a\nb" mostra a b numa página. Imprima você mesmo o <br>, ou mantenha as quebras no texto e converta-as com nl2br(), que insere <br /> antes de cada uma. Rode e compare as abas Output e 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";

Na aba Output, os três parecem iguais. Na aba Page, o primeiro fica todo numa linha, o nl2br() o quebra, e o <pre> mantém as quebras como foram escritas.

Mostrar o texto de um textarea com as quebras de linha

O texto de um <textarea> mantém as linhas que o usuário digitou, mas você precisa escapá-lo antes de imprimi-lo no HTML. A ordem importa: primeiro htmlspecialchars(), depois nl2br(), senão as próprias tags <br /> seriam escapadas. Rode, digite algumas linhas na caixa e clique em Preview: o mesmo script roda de novo com $_POST preenchido.

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

Uma quebra de linha de textarea pode chegar como "\r\n" ou "\n"; as duas contêm "\n", então contar esse caractere funciona nos dois casos. O htmlspecialchars() explica por que escapar não é opcional aqui.

Dividir uma string por quebra de linha

explode("\n", $text) funciona para textos que você mesmo criou. Para textos de usuários ou de arquivos, os fins de linha podem ser "\r\n", "\n" ou "\r"; preg_split('/\R/', $text) lida com todos, porque \R bate com qualquer quebra de linha.

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

Remover quebras de linha de uma string

Para transformar um texto de várias linhas numa linha só, substitua todos os tipos de fim de linha. Substitua "\r\n" antes dos caracteres isolados, senão cada quebra de linha do Windows viraria dois espaços:

<?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() e rtrim() removem quebras de linha nas pontas de uma string, mas nunca no meio, então são a ferramenta certa para uma linha lida de um arquivo e a errada para juntar linhas.