Andare a capo in PHP: \n, PHP_EOL e nl2br

Scrivi \n dentro una stringa tra virgolette doppie per stampare una nuova riga: echo "Line 1\nLine 2";. La costante PHP_EOL fa lo stesso e si legge meglio alla fine di una riga: echo 'Done' . PHP_EOL;. In una pagina web un a capo non appare come interruzione di riga; lì ti servono <br> o nl2br().

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

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

Apici singoli e virgolette doppie

Le sequenze di escape come \n e \t funzionano solo tra virgolette doppie. Tra apici singoli, '\n' è formato da due caratteri: una barra rovesciata e la lettera n. È il motivo abituale per cui "\n non funziona".

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

La pagina sulle stringhe elenca tutte le sequenze di escape che le virgolette doppie riconoscono.

PHP_EOL e "\n"

PHP_EOL è il fine riga del sistema su cui gira PHP: "\n" su Linux e macOS, "\r\n" su Windows. Usalo per l'output nel terminale e per i file che leggerai sulla stessa macchina. Quando un formato definisce il suo fine riga, usa quello: le intestazioni HTTP e le email richiedono "\r\n", e la maggior parte degli strumenti legge senza problemi "\n" ovunque.

<?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" è un ritorno carrello, "\n" un avanzamento di riga. I file Windows terminano le righe con entrambi, "\r\n", ed è per questo che il testo di un utente Windows o di una <textarea> contiene spesso caratteri \r inattesi.

A capo in HTML: br e nl2br

Un browser riduce gli a capo a un singolo spazio, quindi echo "a\nb" mostra a b su una pagina. O stampi tu <br>, oppure mantieni gli a capo nel testo e li converti con nl2br(), che inserisce <br /> prima di ciascuno. Eseguilo e confronta le schede 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";

Nella scheda Output i tre sembrano simili. Nella scheda Page il primo finisce tutto su una riga, nl2br() lo divide e <pre> mantiene gli a capo come sono scritti.

Mostrare l'input di una textarea con i suoi a capo

Il testo di una <textarea> mantiene le righe scritte dall'utente, ma devi applicare l'escape prima di stamparlo nell'HTML. L'ordine conta: prima htmlspecialchars(), poi nl2br(), altrimenti verrebbero sottoposti a escape i tag <br /> stessi. Eseguilo, scrivi qualche riga nella casella e premi Preview: lo stesso script viene eseguito di nuovo con $_POST compilato.

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

Un a capo di una textarea può arrivare come "\r\n" o "\n"; entrambi contengono "\n", quindi contare quel carattere funziona in tutti e due i casi. htmlspecialchars() spiega perché qui l'escape non è facoltativo.

Dividere una stringa per righe

explode("\n", $text) funziona per il testo che hai creato tu. Per il testo di utenti o file, i fine riga possono essere "\r\n", "\n" o "\r"; preg_split('/\R/', $text) li gestisce tutti, perché \R corrisponde a qualsiasi interruzione di riga.

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

Rimuovere le interruzioni di riga da una stringa

Per trasformare un testo su più righe in una sola riga, sostituisci ogni tipo di fine riga. Sostituisci "\r\n" prima dei singoli caratteri, altrimenti ogni a capo di Windows diventerebbe due spazi:

<?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() rimuovono gli a capo alle estremità di una stringa ma mai in mezzo, quindi sono lo strumento giusto per una riga letta da un file e quello sbagliato per unire delle righe.