HOWTO · PHP

Comment créer une nouvelle ligne en PHP

Choisissez le saut de ligne PHP adapté au texte, aux fichiers suivant la convention de la plateforme ou au HTML : découvrez `\n`, `PHP_EOL`, `\r\n` et `<br>`.

Sur cette page

Pour insérer un saut de ligne en PHP, choisissez la représentation adaptée à la destination du résultat. Utilisez \n dans une chaîne entre guillemets doubles pour séparer des lignes de texte, et PHP_EOL si le texte doit suivre la convention de fin de ligne de la plateforme actuelle. Pour afficher un saut de ligne dans un navigateur, produisez du HTML, par exemple <br> : un saut de ligne dans le code source HTML ne produit généralement pas de saut visible à l’écran. Ces solutions ne sont pas interchangeables : le navigateur interprète le HTML, tandis qu’un terminal ou un lecteur de fichier texte traite des caractères.

Choisir le saut de ligne selon le format de sortie

Pour les messages de terminal, les journaux et les fichiers texte brut, insérez un caractère de saut de ligne dans la chaîne ou utilisez PHP_EOL si le fichier doit suivre la convention de la plateforme. Pour les réponses HTML, utilisez un balisage que le navigateur peut interpréter. Choisissez en fonction du logiciel qui lira le résultat, et pas seulement du système d’exploitation sur lequel PHP s’exécute. Si le résultat doit être lu à la fois comme du texte et comme du HTML, créez un format distinct pour chaque usage au lieu de mélanger balisage et fins de ligne dans une même chaîne.

Utiliser \n dans une chaîne PHP

Dans une chaîne PHP entre guillemets doubles, \n représente un saut de ligne (LF). Une chaîne entre guillemets simples n’interprète pas \n comme un saut de ligne : elle conserve la séquence avec sa barre oblique inverse, sous réserve des règles limitées d’échappement des guillemets simples en PHP. Utilisez des guillemets doubles pour que PHP interprète cette séquence. Deux sauts de ligne consécutifs laissent une ligne vide entre deux lignes de texte.

Exécutez cet exemple :

Le code et les libellés ou sorties affichés dans cette section restent en anglais.

<?php
$message = "Hello, PHP!\nWelcome back.";
echo $message, "\n";
?>

Résultat attendu :

Hello, PHP!
Welcome back.

Cette méthode convient à la sortie d’un terminal et au contenu textuel. Lors de l’écriture dans un fichier, les octets de la chaîne sont écrits tels quels : choisissez donc la convention de fin de ligne attendue par le programme qui lira ce fichier.

Utiliser PHP_EOL pour du texte adapté à la plateforme

PHP_EOL contient la séquence de fin de ligne de la plateforme sur laquelle PHP s’exécute. Vous pouvez la concaténer entre des lignes de texte, par exemple, "First" . PHP_EOL . "Second". Elle convient à la sortie d’un terminal et aux fichiers texte destinés à cet environnement. Elle ne crée pas de saut de ligne visible en HTML : lorsqu’il affiche un paragraphe, le navigateur peut réduire les espaces blancs du code source. Par ailleurs, un fichier destiné à un format d’échange précis peut exiger une fin de ligne fixe ; utilisez alors les caractères imposés par ce format au lieu de supposer que la convention de la plateforme convient.

Utiliser <br> pour les sauts de ligne en HTML

Lors de la génération de HTML, <br> est un élément de saut de ligne. Par exemple, PHP peut produire "First line<br>Second line", et un moteur de rendu HTML affiche alors le texte sur des lignes distinctes. Dans le code source HTML, un caractère de saut de ligne est généralement traité comme un espace blanc et ne garantit pas de saut visible. À l’inverse, si <br> est affiché dans un terminal, il apparaît comme du balisage littéral et ne fait pas passer le curseur à la ligne suivante. Échappez les valeurs non fiables avant de les insérer dans du HTML : l’élément de saut de ligne ne sécurise pas le contenu qui l’entoure.

Comprendre \r\n et les lignes vides

\r\n se compose d’un retour chariot suivi d’un saut de ligne. C’est la fin de ligne conventionnelle de nombreux fichiers texte Windows. Dans une chaîne PHP entre guillemets doubles, les deux séquences d’échappement produisent ces deux caractères de contrôle. Utilisez cette séquence lorsqu’un format de destination exige explicitement CRLF ; sinon, PHP_EOL convient au texte qui suit la convention de la plateforme, tandis que \n est courant dans les formats qui imposent LF. Pour créer une ligne vide, ajoutez une séquence de fin de ligne complète supplémentaire, par exemple "First\n\nSecond". Le retour chariot n’est pas une instruction PHP qui réinitialise un pointeur de sortie : c’est un caractère dont l’effet à l’affichage dépend du périphérique de sortie.

Erreurs courantes et vérifications rapides

  • Si \n apparaît littéralement, vérifiez si la chaîne est entre guillemets simples. Utilisez des guillemets doubles ou créez le saut de ligne autrement.
  • Si un navigateur affiche le texte sur une seule ligne, vérifiez le HTML rendu. Utilisez <br> ou une règle CSS adaptée au lieu de compter sur les espaces blancs du code source.
  • Si <br> apparaît dans un terminal ou dans un fichier texte brut, le résultat est traité comme du texte. Utilisez plutôt \n ou PHP_EOL.
  • Si un autre programme rejette un fichier texte, vérifiez la convention de fin de ligne qu’il exige. \n, \r\n et PHP_EOL peuvent produire des séquences d’octets différentes.

Choisissez la représentation en fonction du prochain lecteur du résultat : la syntaxe des chaînes PHP pour les sauts de ligne dans le texte, PHP_EOL pour les fichiers texte suivant la convention de la plateforme, la séquence imposée pour un format de fichier précis et <br> pour le HTML affiché dans un navigateur.