PHP echo: imprimir texto, variables y HTML

echo imprime texto. Escribe echo "Hello"; para mostrar una cadena, echo "Hello, $name"; para incluir una variable y echo $a, $b; para imprimir varios valores seguidos. Lo que imprime echo se convierte en la página que muestra el navegador, o en el texto que ves en una terminal.

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

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

La primera línea usa interpolación (la variable está dentro de comillas dobles), la segunda une cadenas con el operador . y la tercera pasa tres valores separados por comas. Las tres imprimen el mismo tipo de resultado.

Imprimir HTML con echo

En una página web, echo suele imprimir HTML. El navegador recibe el texto y renderiza las etiquetas. Pulsa Ejecutar y la pestaña Página muestra el resultado renderizado:

<?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 última línea usa comillas simples para que las comillas dobles de class="note" no necesiten escaparse. Dentro de comillas simples las variables no se sustituyen, así que úsalas para texto fijo. Si un valor viene de un visitante (un formulario, la URL), imprímelo a través de htmlspecialchars para que no pueda inyectar HTML; consulta la página de htmlspecialchars.

La etiqueta corta de echo <?=

Dentro de un archivo HTML, <?= $value ?> es la forma corta de <?php echo $value; ?>. Mantiene legibles las plantillas:

<?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 etiqueta corta de echo está siempre disponible. La otra etiqueta corta, <? sin php, depende de una configuración y no debería usarse.

Imprimir varios valores y saltos de línea

echo no añade un salto de línea. En una terminal, añade "\n" (entre comillas dobles) o la constante PHP_EOL. En HTML, un salto de línea en el código fuente no tiene efecto visible; usa <br> o elementos separados.

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

Las comas y los puntos dan la misma salida. Con comas, echo imprime cada valor por turno; con puntos, PHP primero construye una sola cadena y luego la imprime. Los saltos de línea tienen su propia página: salto de línea en PHP.

echo vs print

print es el hermano mayor. Imprime un valor y siempre devuelve 1, lo que le permite aparecer dentro de una expresión. echo acepta cualquier número de valores y no devuelve nada.

<?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 es otra cosa: formatea valores con marcadores, como printf("%05.2f", 3.14159), y se explica en la página de sprintf.

Imprimir un array o un objeto con echo

echo solo imprime cadenas y valores que se convierten en cadena (números, booleanos, null). Un array no se convierte. Tu propio PHP imprime un aviso y la palabra Array:

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

Para mostrar el contenido, elige la función adecuada:

<?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 objeto es más estricto: salvo que su clase defina __toString(), echo $object; detiene el script con Error: Object of class User could not be converted to string. Los booleanos también suelen sorprender: echo true; imprime 1 y echo false; no imprime nada. Usa var_dump($value) cuando necesites ver el tipo y el valor exactos.

Error frecuente: echo con paréntesis y comas

Como echo parece una función, hay quien escribe echo("a", "b");. Eso es un error de sintaxis, porque los paréntesis envuelven una sola expresión:

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

Quita los paréntesis (echo "a", "b";) o une los valores (echo("a" . "b");). Lo mismo vale para print, que nunca acepta un segundo valor, con o sin paréntesis.