HOWTO · PHP
Crea una nuova riga in PHP
Scopri come scegliere l’interruzione di riga in PHP per testo, file con terminazione nativa o HTML, usando `\n`, `PHP_EOL`, `\r\n` e `<br>.
In questa pagina
Per inserire un’interruzione di riga in PHP, scegli la rappresentazione in base a come verrà letto l’output. Usa \n in una stringa tra virgolette doppie per andare a capo nel testo e PHP_EOL quando il testo deve seguire la convenzione della piattaforma corrente. Per ottenere un’interruzione visibile nel browser, genera HTML come <br>: una nuova riga nel solo sorgente HTML, di solito, non produce un’interruzione visibile. Queste soluzioni non sono intercambiabili: il browser interpreta l’HTML, mentre un terminale o un lettore di file di testo elabora caratteri.
Scegliere l’interruzione di riga in base al formato di output
Per i messaggi della CLI, i log e i file di testo semplice, inserisci un carattere di nuova riga nella stringa oppure usa PHP_EOL se il file deve seguire la convenzione della piattaforma. Per le risposte HTML, usa markup che il browser possa interpretare. Scegli in base a chi leggerà l’output, non soltanto al sistema operativo su cui gira PHP. Se l’output può essere letto sia come testo sia come HTML, prepara formati distinti invece di mescolare markup e terminazioni di riga testuali nella stessa stringa.
Usare \n in una stringa PHP
In una stringa PHP tra virgolette doppie, \n rappresenta un avanzamento riga. Una stringa tra virgolette singole non interpreta \n come un’interruzione di riga: conserva la sequenza con la barra inversa, salvo le limitate regole di escape previste da PHP per le virgolette singole. Usa le virgolette doppie quando vuoi che PHP interpreti questa sequenza di escape. Due avanzamenti riga consecutivi lasciano una riga vuota tra le righe di testo.
Esegui questo esempio:
Il codice e le etichette o gli output visibili in questa sezione restano in inglese.
<?php
$message = "Hello, PHP!\nWelcome back.";
echo $message, "\n";
?>
Output previsto:
Hello, PHP!
Welcome back.
Questo metodo è adatto all’output del terminale e ai contenuti testuali. Quando scrivi un file, i byte della stringa vengono scritti così come sono: scegli quindi la convenzione di terminazione di riga richiesta dal programma che leggerà il file.
Usare PHP_EOL per il testo con terminazione di riga nativa della piattaforma
PHP_EOL contiene la sequenza di terminazione di riga della piattaforma su cui gira PHP. Concatenala tra le righe di testo, per esempio, \"First\" . PHP_EOL . \"Second\". È utile per l’output della CLI e per i file di testo destinati a quell’ambiente. Non crea un’interruzione HTML visibile: quando visualizza un paragrafo, il browser può comprimere gli spazi presenti nel sorgente. Inoltre, un file destinato a uno specifico formato di interscambio può richiedere una terminazione di riga fissa: usa i caratteri prescritti da quel formato invece di presumere che vada bene la convenzione della piattaforma host.
Usare <br> per le interruzioni di riga in HTML
Quando generi HTML, <br> è un elemento che inserisce un’interruzione di riga. Per esempio, PHP può produrre \"First line<br>Second line\" e un renderer HTML visualizzerà il testo su righe separate. In genere, un carattere di nuova riga nel sorgente HTML viene trattato come uno spazio, non come un’interruzione visibile garantita. Al contrario, se stampi <br> in un terminale, apparirà come markup letterale e non sposterà il cursore alla riga successiva. Esegui l’escape dei valori non attendibili prima di inserirli nell’HTML: l’elemento di interruzione di riga non rende sicuro il contenuto circostante.
Capire \r\n e le righe vuote
\r\n è composto da un ritorno a capo seguito da un avanzamento riga. È la convenzione di terminazione di riga usata in molti file di testo Windows. In una stringa PHP tra virgolette doppie, le due sequenze di escape producono quei due caratteri di controllo. Usa questa sequenza quando il formato di destinazione richiede esplicitamente CRLF; altrimenti, PHP_EOL è comodo per il testo con terminazione di riga nativa della piattaforma, mentre \n è comune nei formati che specificano l’avanzamento riga. Per creare una riga vuota, aggiungi un’altra sequenza completa di terminazione di riga, per esempio \"First\\n\\nSecond\". Il ritorno a capo non è un’istruzione PHP per azzerare un puntatore di output: è un carattere il cui effetto visivo dipende dal dispositivo di output.
Errori comuni e controlli rapidi
- Se
\nappare letteralmente, controlla se la stringa usa le virgolette singole. Usa le virgolette doppie oppure crea l’interruzione di riga in un altro modo. - Se il browser visualizza il testo su una sola riga, controlla l’HTML renderizzato. Usa
<br>o il CSS appropriato invece di affidarti agli spazi nel sorgente. - Se
<br>appare in un terminale o in un file di testo semplice salvato, l’output viene letto come testo. Usa invece\noPHP_EOL. - Se un altro programma rifiuta un file di testo, verifica la convenzione di terminazione di riga richiesta.
\n,\r\nePHP_EOLpossono produrre sequenze di byte diverse.
Scegli la rappresentazione in base a chi leggerà l’output: la sintassi delle stringhe PHP per gli avanzamenti riga nel testo, PHP_EOL per i file di testo con terminazione nativa, la sequenza prescritta per un formato con terminazione fissa e <br> per l’HTML visualizzato nel browser.