PHP echo : afficher du texte, des variables et du HTML

echo affiche du texte. Écrivez echo "Hello"; pour afficher une chaîne, echo "Hello, $name"; pour y inclure une variable, et echo $a, $b; pour afficher plusieurs valeurs à la suite. Ce qu'affiche echo devient la page que montre le navigateur, ou le texte que vous voyez dans un terminal.

<?php
$name = "Ada";
$lessons = 12;

echo "Hello, $name\n";
echo "You finished " . $lessons . " lessons.\n";
echo "Name: ", $name, ", lessons: ", $lessons, "\n";

La première ligne utilise l'interpolation (la variable se trouve entre guillemets doubles), la deuxième assemble des chaînes avec l'opérateur ., et la troisième passe trois valeurs séparées par des virgules. Les trois affichent le même genre de résultat.

Afficher du HTML avec echo

Dans une page web, echo affiche généralement du HTML. Le navigateur reçoit le texte et interprète les balises. Cliquez sur Run et l'onglet Page montre le rendu :

<?php
$title = "Today's specials";
$specials = ["Tomato soup", "Grilled cheese", "Apple pie"];

echo "<h2>$title</h2>";
echo "<ul>";
foreach ($specials as $dish) {
    echo "<li>$dish</li>";
}
echo "</ul>";
echo '<p class="note">Served from 12:00 to 15:00.</p>';

La dernière ligne utilise des guillemets simples, ce qui évite d'échapper les guillemets doubles de class="note". Entre guillemets simples, les variables ne sont pas remplacées : réservez-les au texte fixe. Si une valeur vient d'un visiteur (un formulaire, l'URL), affichez-la via htmlspecialchars pour qu'elle ne puisse pas injecter de HTML ; voir la page htmlspecialchars.

La balise echo courte <?=

Dans un fichier HTML, <?= $value ?> est la forme courte de <?php echo $value; ?>. Elle garde les templates lisibles :

<?php
$user = ["name" => "Grace", "points" => 1450, "level" => 7];
?>
<div class="card">
    <h3><?= $user["name"] ?></h3>
    <p>Level <?= $user["level"] ?>, <?= number_format($user["points"]) ?> points</p>
    <p>Next level in <?= 2000 - $user["points"] ?> points</p>
</div>

La balise echo courte est toujours disponible. L'autre balise courte, <? sans php, dépend d'un réglage et ne doit pas être utilisée.

Afficher plusieurs valeurs et des retours à la ligne

echo n'ajoute pas de saut de ligne. Dans un terminal, ajoutez "\n" (entre guillemets doubles) ou la constante PHP_EOL. En HTML, un saut de ligne dans le code source ne produit rien de visible ; utilisez <br> ou des éléments séparés.

<?php
$first = "Ada";
$last = "Lovelace";

echo $first, " ", $last, "\n";      // commas: values printed one after another
echo $first . " " . $last . "\n";   // dots: one joined string, then printed
echo "Line one" . PHP_EOL . "Line two" . PHP_EOL;
echo 'Single quotes print \n as two characters', "\n";

Les virgules et les points donnent le même affichage. Avec des virgules, echo affiche chaque valeur à tour de rôle ; avec des points, PHP construit d'abord une seule chaîne puis l'affiche. Les sauts de ligne ont leur propre page : retour à la ligne en PHP.

echo ou print

print est le grand frère plus ancien. Il affiche une seule valeur et renvoie toujours 1, ce qui lui permet d'apparaître dans une expression. echo accepte autant de valeurs que vous voulez et ne renvoie rien.

<?php
print "Printed with print\n";
echo "Printed with echo\n";

$result = print "print returns ";
echo $result, "\n";

echo "a", "b", "c", "\n";      // echo: many values
// print "a", "b";             // parse error: print takes one value

printf est encore différent : il formate des valeurs avec des marqueurs, comme printf("%05.2f", 3.14159), et il est expliqué sur la page sprintf.

Afficher un tableau ou un objet avec echo

echo n'affiche que des chaînes et des valeurs convertibles en chaînes (nombres, booléens, null). Un tableau ne se convertit pas. Votre PHP affiche un avertissement et le mot Array :

PHP Warning:  Array to string conversion in /home/index.php on line 3
Array

Pour afficher le contenu, choisissez la fonction adaptée :

<?php
$tags = ["php", "echo", "basics"];

echo implode(", ", $tags), "\n";    // values as one string
print_r($tags);                     // readable structure
echo "\n";
echo json_encode($tags), "\n";      // JSON text
echo "First tag: {$tags[0]}\n";     // one element inside a string

Un objet est plus strict : à moins que sa classe ne définisse __toString(), echo $object; arrête le script avec Error: Object of class User could not be converted to string. Les booléens surprennent aussi souvent : echo true; affiche 1 et echo false; n'affiche rien du tout. Utilisez var_dump($value) quand vous avez besoin de voir le type et la valeur exacts.

Erreur fréquente : echo avec des parenthèses et des virgules

Comme echo ressemble à une fonction, on écrit parfois echo("a", "b");. C'est une erreur de syntaxe, car les parenthèses entourent une seule expression :

PHP Parse error:  syntax error, unexpected token "," in /home/index.php on line 2

Retirez les parenthèses (echo "a", "b";) ou assemblez les valeurs (echo("a" . "b");). C'est pareil pour print, qui n'accepte jamais de seconde valeur, avec ou sans parenthèses.