PHP echo: imprimir texto, variáveis e HTML

echo imprime texto. Escreva echo "Hello"; para mostrar uma string, echo "Hello, $name"; para incluir uma variável, e echo $a, $b; para imprimir vários valores em sequência. Tudo o que o echo imprime vira a página que o navegador mostra, ou o texto que você vê num terminal.

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

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

A primeira linha usa interpolação (a variável fica dentro das aspas duplas), a segunda junta strings com o operador ., e a terceira passa três valores separados por vírgulas. As três imprimem o mesmo tipo de resultado.

Imprimir HTML com echo

Numa página web, o echo normalmente imprime HTML. O navegador recebe o texto e renderiza as tags. Clique em Run e a aba Page mostra o 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>';

A última linha usa aspas simples para que as aspas duplas de class="note" não precisem de escape. Dentro de aspas simples as variáveis não são substituídas, então use-as para texto fixo. Se um valor vem de um visitante (um formulário, a URL), imprima-o com htmlspecialchars para que ele não consiga injetar HTML; veja a página sobre htmlspecialchars.

A tag curta de echo <?=

Dentro de um arquivo HTML, <?= $value ?> é a forma curta de <?php echo $value; ?>. Ela deixa os templates legíveis:

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

A tag curta de echo está sempre disponível. A outra tag curta, <? sem php, depende de uma configuração e não deve ser usada.

Imprimir vários valores e quebras de linha

O echo não adiciona quebra de linha. Num terminal, adicione "\n" (entre aspas duplas) ou a constante PHP_EOL. Em HTML, uma quebra de linha no código-fonte não aparece; use <br> ou 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";

Vírgulas e pontos dão a mesma saída. Com vírgulas, o echo imprime cada valor por vez; com pontos, o PHP primeiro monta uma única string e depois a imprime. Quebras de linha têm uma página própria: quebra de linha no PHP.

echo ou print

print é o irmão mais velho. Ele imprime um valor e sempre retorna 1, o que permite usá-lo dentro de uma expressão. echo recebe qualquer quantidade de valores e não retorna 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 é outra coisa: ele formata valores com marcadores, como printf("%05.2f", 3.14159), e é explicado na página sobre sprintf.

Imprimir um array ou um objeto

O echo só imprime strings e valores que viram string (números, booleanos, null). Um array não vira. No seu PHP, aparece um aviso e a palavra Array:

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

Para mostrar o conteúdo, escolha a função certa para o caso:

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

Um objeto é mais rígido: a menos que a classe defina __toString(), echo $object; interrompe o script com Error: Object of class User could not be converted to string. Booleanos também costumam surpreender: echo true; imprime 1 e echo false; não imprime nada. Use var_dump($value) quando precisar ver o tipo e o valor exatos.

Erro comum: echo com parênteses e vírgulas

Como o echo parece uma função, muita gente escreve echo("a", "b");. Isso é um erro de sintaxe, já que os parênteses envolvem uma única expressão:

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

Tire os parênteses (echo "a", "b";) ou junte os valores (echo("a" . "b");). O mesmo vale para o print, que nunca aceita um segundo valor, com ou sem parênteses.