PHP Interpolação

Você já sabe juntar textos com o ponto: "Olá, " . $nome . "!". Funciona, mas cansa e é fácil esquecer um ponto ou um espaço. O PHP tem um atalho: escrever a variável dentro das aspas duplas, e ele troca pelo valor. Isso se chama interpolação.

A ideia: um formulário com lacunas

Pense num modelo de recado impresso: "Olá, ______! Sua nota foi ______." Você preenche as lacunas e entrega. Na interpolação, o texto entre aspas duplas é o modelo, e cada $variavel é uma lacuna que o PHP preenche com o valor no momento em que a linha roda.

A palavra vem do latim interpolare, "inserir no meio". Em inglês: string interpolation.

Só nas aspas duplas

<?php
$nome = "Ana";
$idade = 29;
echo "Olá, $nome! Você tem $idade anos.\n";
echo 'Olá, $nome!', "\n";

"Olá, $nome! …"

Aspas duplas: o PHP procura $ seguido de um nome e troca pelo valor da variável. O \n também vira uma quebra de linha.

'Olá, $nome!'

Aspas simples: o texto sai exatamente como está, com o cifrão e tudo. Nada é trocado.

$ php ola.php
Olá, Ana! Você tem 29 anos.
Olá, $nome!          « aspas simples: literal

O número 29 virou texto automaticamente (veja Conversão de Tipos). As diferenças entre os dois tipos de aspas estão em Strings; aqui o foco é o que pode ir dentro das duplas.

Onde o nome da variável termina?

Quando o PHP vê um $ nas aspas duplas, ele lê o nome da variável enquanto houver letras, números ou _. O primeiro caractere diferente (espaço, ponto, vírgula, @, /, -, aspa…) encerra o nome.

<?php
$nome = "Ana";
$total = 13.5;
echo "Email: $nome@escola.com\n";
echo "Arquivo: $nome.txt\n";
echo "Pasta: /home/$nome/\n";
echo "$nome's notebook\n";
echo "R$ $total\n";
echo "Custa $5\n";

$ php fim-nome.php
Email: Ana@escola.com      « o @ encerrou o nome
Arquivo: Ana.txt           « o ponto também
Pasta: /home/Ana/
Ana's notebook             « a aspa simples também
R$ 13.5                    « "$ " (cifrão + espaço) não é variável: fica como está
Custa $5                   « nome de variável não pode começar com número: fica como está

O problema aparece quando a palavra seguinte gruda no nome. A Ana quer escrever "Anas" (o plural de brincadeira):

<?php
$nome = "Ana";
echo "Total: $nomes\n";
echo "Total: {$nome}s\n";

$ php grudado.php

Warning: Undefined variable $nomes in /home/ana/php/grudado.php on line 3
Total:                     « $nomes não existe: vira texto vazio
Total: Anas                « com chaves: o nome acaba no }

O PHP leu $nomes inteiro, procurou essa variável, não achou, avisou com Warning e usou texto vazio. O programa continuou (é um aviso, não um erro fatal; veja Lendo Erros do PHP).

As chaves {$…}

Colocar a variável entre chaves marca exatamente onde ela começa e termina. É a forma "completa" da interpolação, e funciona para tudo que você vai ver nesta aula.

{

Abre. Precisa vir colado no $: {$.

$nome

A variável (ou um array, ou um objeto, como você vai ver).

}

Fecha. As chaves não aparecem na saída.

s

O texto que vem depois, grudado.

Se houver espaço entre { e $, as chaves viram texto comum:

<?php
$nome = "Ana";
echo "Com espaço: { $nome}\n";
echo "Sem dólar: {nome}\n";

$ php chaves.php
Com espaço: { Ana}         « as chaves apareceram; só o $nome foi trocado
Sem dólar: {nome}          « sem $, nada acontece

$ php antigo.php

Deprecated: Using ${var} in strings is deprecated, use {$var} instead in /home/ana/php/antigo.php on line 3
Total: Anas

<?php
$fruta = "maçã";
echo "Comprei 3 $frutas";

<?php
$fruta = "maçã";
echo "Comprei 3 {$fruta}s";

Arrays dentro do texto

Com arrays associativos (listas com "etiquetas", como "nome" e "nota"), existem duas formas que funcionam e uma que dá erro:

<?php
$aluno = ["nome" => "Bruno", "nota" => 8.5];
$frutas = ["maçã", "uva"];
echo "Aluno: {$aluno['nome']}, nota {$aluno['nota']}\n";
echo "Aluno: $aluno[nome], nota $aluno[nota]\n";
echo "Fruta: $frutas[0] e {$frutas[1]}\n";

$ php array.php
Aluno: Bruno, nota 8.5
Aluno: Bruno, nota 8.5
Fruta: maçã e uva

A forma curta $aluno[nome] confunde, porque fora das aspas $aluno[nome] (sem aspas na chave) é um erro. Por isso, a recomendação é simples: array dentro do texto, sempre com chaves.

Arrays dentro de arrays

Para mais de um nível, só as chaves funcionam:

<?php
$turma = ["alunos" => [["nome" => "Bruno"]]];
echo "Primeiro: {$turma['alunos'][0]['nome']}\n";
echo "Primeiro: $turma[alunos][0][nome]\n";

$ php turma.php
Primeiro: Bruno

Warning: Array to string conversion in /home/ana/php/turma.php on line 4
Primeiro: Array[0][nome]

Na segunda linha, a forma curta só leu $turma[alunos] (que é um array) e tratou [0][nome] como texto comum. Um array inteiro não pode virar texto: o PHP avisa "conversão de array para string" e escreve a palavra Array. (Arrays dentro de arrays são o assunto de Arrays Multidimensionais.)

<?php
$aluno = ["nome" => "Bruno", "nota" => 8.5, "materia" => "Matemática"];
echo "nome tirou nota em materia";

<?php
$aluno = ["nome" => "Bruno", "nota" => 8.5, "materia" => "Matemática"];
echo "{$aluno['nome']} tirou {$aluno['nota']} em {$aluno['materia']}";

Objetos dentro do texto

Um objeto é parecido com um array associativo, mas os dados (as propriedades) são acessados com a setinha ->. Você vai criar os seus em Classes e Objetos; aqui usamos o objeto "genérico" do PHP, o stdClass, só para ver a interpolação.

<?php
$aluna = new stdClass();
$aluna->nome = "Ana";
$aluna->cidade = "Recife";
echo "Professora: $aluna->nome, de $aluna->cidade\n";
echo "Professora: {$aluna->nome}\n";

$ php objeto.php
Professora: Ana, de Recife
Professora: Ana

Como nos arrays, a forma sem chaves só vai um nível. Se a propriedade for outro objeto ($aluna->endereco->cidade), ou se você quiser chamar um método ($aluna->apresentar()), use chaves: "{$aluna->endereco->cidade}", "{$aluna->apresentar()}". Sem chaves, o PHP para no primeiro nível e tenta transformar o objeto inteiro em texto, o que dá erro fatal:

$ php objeto2.php

Fatal error: Uncaught Error: Object of class stdClass could not be converted to string in /home/ana/php/objeto2.php:6
Stack trace:
#0 {main}
  thrown in /home/ana/php/objeto2.php on line 6

O que não é interpolado

A interpolação troca variáveis. Ela não faz contas, não chama funções soltas e não conhece constantes:

<?php
const ESCOLA = "Escola Sol";
$preco = 4.5;
$qtd = 3;
echo "Escola: ESCOLA\n";
echo "Nome: {strtoupper('ana')}\n";
echo "Total: $preco * $qtd\n";
echo "Total: " . $preco * $qtd . "\n";

$ php nao.php
Escola: ESCOLA                  « constante: fica o nome, literal
Nome: {strtoupper('ana')}       « { sem $ logo depois: texto comum
Total: 4.5 * 3                  « trocou as variáveis, mas a conta não foi feita
Total: 13.5                     « fora das aspas, com concatenação, a conta funciona

E se você tentar fazer a conta dentro das chaves?

<?php
$qtd = 3;
echo "Total: {$qtd * 2}\n";

$ php conta.php

Parse error: syntax error, unexpected token "*", expecting "->" or "?->" or "[" in /home/ana/php/conta.php on line 3

"Erro de sintaxe: * inesperado; esperava ->, ?-> ou [". Dentro de {$…}, o PHP só aceita uma variável seguida de […] (array) ou -> (objeto). Faça a conta antes, numa variável ($total = $qtd * 2;), ou concatene.

Valores que viram texto de um jeito estranho

<?php
$nada = null;
$sim = true;
$nao = false;
$lista = [1, 2];
echo "null:[$nada] true:[$sim] false:[$nao]\n";
echo "Lista: $lista\n";

$ php tipos.php
null:[] true:[1] false:[]

Warning: Array to string conversion in /home/ana/php/tipos.php on line 7
Lista: Array

null e false viram texto vazio; true vira "1". Um array inteiro vira a palavra Array, com aviso. Para mostrar uma lista, junte-a antes com implode (veja Funções de String).

Caracteres especiais nas aspas duplas

Além das variáveis, as aspas duplas entendem sequências de escape: uma barra invertida seguida de uma letra.

<?php
$nome = "Ana";
echo "Barra: \\ Aspas: \" Tab:[\t] Dólar: \$nome\n";
echo "Unicode: \u{e9} \u{1F600}\n";

$ php escapes.php
Barra: \ Aspas: " Tab:[	] Dólar: $nome
Unicode: é 😀

Para escrever {$ literalmente, use {\$.

Interpolar, concatenar ou sprintf?

As três formas abaixo produzem a mesma frase:

<?php
$nome = "Ana";
$nota = 9.5;
echo "Aluna $nome tirou $nota.\n";
echo 'Aluna ' . $nome . ' tirou ' . $nota . ".\n";
echo sprintf("Aluna %s tirou %.1f.\n", $nome, $nota);

$ php formas.php
Aluna Ana tirou 9.5.
Aluna Ana tirou 9.5.
Aluna Ana tirou 9.5.

sprintf e printf têm uma aula só para eles: printf e sprintf.

Quando dá errado

$ php grudado.php

Warning: Undefined variable $nomes in /home/ana/php/grudado.php on line 3
Total: 

<?php
$aluno = ["nome" => "Bruno"];
echo "Aluno: $aluno['nome']\n";

$ php aspas-chave.php

Parse error: syntax error, unexpected string content "", expecting "-" or identifier or variable or number in /home/ana/php/aspas-chave.php on line 3

$ php tipos.php
null:[] true:[1] false:[]

Warning: Array to string conversion in /home/ana/php/tipos.php on line 7
Lista: Array

$ php ola.php
Olá, Ana! Você tem 29 anos.
Olá, $nome!          « a segunda linha usa aspas simples

Referência

Exercícios

<?php
$item = ["fruta" => "maçã", "preco" => 4.5];
$qtd = 3;
echo "$qtd x $item = R$ $qtd * $item";

<?php
$item = ["fruta" => "maçã", "preco" => 4.5];
$qtd = 3;
$total = $qtd * $item['preco'];
echo "$qtd x {$item['fruta']} = R$ $total";

Resumo

• Interpolação: nas aspas duplas, $var é trocada pelo valor. Nas simples, não.
• O nome da variável vai até o primeiro caractere que não é letra, número ou _. Texto grudado? Use {$var}.
• Arrays e objetos: prefira sempre as chaves, {$aluno['nome']} e {$aluna->nome}. A forma curta só vai um nível e não aceita aspas na chave.
• "${var}" é obsoleto desde o PHP 8.2.
• Contas, funções e constantes não são interpoladas: calcule antes, concatene ou use sprintf.
• null/false viram vazio, true vira 1, array vira Array com aviso.