PHP echo: stampare testo, variabili e HTML

echo stampa testo. Scrivi echo "Hello"; per stampare una stringa, echo "Hello, $name"; per includere una variabile, e echo $a, $b; per stampare più valori di fila. Ciò che echo stampa diventa la pagina mostrata dal browser, oppure il testo che vedi in un terminale.

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

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

La prima riga usa l'interpolazione (la variabile sta dentro le virgolette doppie), la seconda unisce le stringhe con l'operatore ., e la terza passa tre valori separati da virgole. Tutte e tre stampano lo stesso tipo di risultato.

Stampare HTML con echo

In una pagina web, echo di solito stampa HTML. Il browser riceve il testo e visualizza i tag. Premi Run e la scheda Page mostra il risultato visualizzato:

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

L'ultima riga usa le virgolette singole, così le virgolette doppie di class="note" non vanno escapate. Dentro le virgolette singole le variabili non vengono sostituite, quindi usale per il testo fisso. Se un valore arriva da un visitatore (un form, l'URL), stampalo passando da htmlspecialchars così non può iniettare HTML; vedi la pagina su htmlspecialchars.

Il tag breve di echo <?=

Dentro un file HTML, <?= $value ?> è la forma breve di <?php echo $value; ?>. Mantiene leggibili i template:

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

Il tag breve di echo è sempre disponibile. L'altro tag breve, <? senza php, dipende da un'impostazione e non andrebbe usato.

Stampare più valori e andare a capo

echo non aggiunge un'interruzione di riga. In un terminale, aggiungi "\n" (tra virgolette doppie) oppure la costante PHP_EOL. In HTML, un a capo nel sorgente non produce nulla di visibile; usa <br> o elementi separati.

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

Virgole e punti danno lo stesso output. Con le virgole, echo stampa ogni valore a turno; con i punti, PHP prima costruisce una stringa unica e poi la stampa. Gli a capo hanno una pagina tutta loro: a capo in PHP.

echo vs print

print è il fratello più vecchio. Stampa un valore e restituisce sempre 1, il che gli permette di comparire dentro un'espressione. echo accetta un numero qualsiasi di valori e non restituisce nulla.

<?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 è ancora diverso: formatta i valori con dei segnaposto, come printf("%05.2f", 3.14159), ed è trattato nella pagina su sprintf.

Stampare un array o un oggetto

echo stampa solo stringhe e valori che si convertono in stringa (numeri, booleani, null). Un array non si converte. Il tuo PHP stampa un warning e la parola Array:

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

Per mostrarne il contenuto, scegli la funzione adatta:

<?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 oggetto è più severo: a meno che la sua classe non definisca __toString(), echo $object; ferma lo script con Error: Object of class User could not be converted to string. Anche i booleani sono una sorpresa frequente: echo true; stampa 1 e echo false; non stampa proprio nulla. Usa var_dump($value) quando ti serve vedere il tipo e il valore esatti.

Errore comune: echo con parentesi e virgole

Siccome echo sembra una funzione, si finisce per scrivere echo("a", "b");. È un errore di sintassi, perché le parentesi racchiudono una sola espressione:

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

Togli le parentesi (echo "a", "b";) oppure unisci i valori (echo("a" . "b");). Lo stesso vale per print, che non accetta mai un secondo valore, con o senza parentesi.