PHP ?? e ?->

Muitas vezes um valor pode estar faltando: o cliente não informou o telefone, o endereço não tem complemento, a página foi aberta sem o nome na URL. O operador ?? resolve isso numa linha: "use este valor; se ele não existir ou for null, use aquele outro". Nesta aula você vai conhecer o ??, o seu irmão ??= e o ?->, que evita um erro fatal quando o objeto é null.

Antes, é bom ter visto null (o valor "nada") e Booleanos. Alguns exemplos usam um array com nomes nas posições, como $aluna["nome"]; basta saber que é uma "ficha" com campos, e a aula Arrays Associativos explica tudo.

A ideia: o plano B

Pense numa ficha de cadastro em papel. Quando a Ana vai ler o campo "Apelido" e ele está em branco, ela usa o nome. Quando o campo "Telefone" está em branco, ela escreve "não informado". Ninguém para o trabalho por causa de um campo vazio: existe um plano B.

O ?? é exatamente isso. Ele olha o valor da esquerda:

• se ele existe e não é null, usa ele;
• senão, usa o valor da direita (o plano B, ou "valor padrão").

O nome oficial é null coalescing operator, "operador de coalescência nula". Coalescer quer dizer "juntar": ele junta vários candidatos e fica com o primeiro que não é null.

O problema: o que não existe gera um aviso

Primeiro, veja o que acontece sem o ?? quando a variável não existe:

<?php
echo $sobrenome, "\n";
echo "fim\n";

$ php sem.php

Warning: Undefined variable $sobrenome in /home/ana/site/sem.php on line 2

fim

O PHP avisa "variável indefinida: $sobrenome" (veja Lendo Erros do PHP), trata o valor como null e continua. Com uma chave de array que não existe, acontece o mesmo:

<?php
$aluna = ["nome" => "Ana", "nota" => 8];

echo $aluna["nome"], "\n";
echo $aluna["email"], "\n";
echo $aluna["email"] ?? "sem e-mail", "\n";

$ php aluno.php
Ana

Warning: Undefined array key "email" in /home/ana/site/aluno.php on line 5

sem e-mail

A linha 5 deu o aviso Undefined array key "email" ("chave de array indefinida") e mostrou uma linha vazia. A linha 6 é a mesma coisa com o ??: nada de aviso, e o plano B apareceu.

O operador ??

<?php
$apelido = null;
$nome = "Ana";

echo $apelido ?? "sem apelido", "\n";
echo $nome ?? "sem nome", "\n";
echo $sobrenome ?? "sem sobrenome", "\n";

$ php coalescencia.php
sem apelido
Ana
sem sobrenome

$apelido

O valor que você quer usar (o plano A).

??

"Se o da esquerda não existir ou for null…"

"sem apelido"

"…use este" (o plano B). Pode ser um texto, um número, outra variável, o resultado de uma conta.

Linha por linha:

Esse "sem Warning" é o grande trunfo do ??. Ele verifica se a variável existe antes de ler o valor. Funciona até com várias chaves seguidas: se o pedido não tiver cliente, $pedido["cliente"]["email"] ?? "sem e-mail" dá "sem e-mail", sem nenhum aviso.

<?php
$aluna = ["nome" => "Ana", "email" => "ana@exemplo.com"];

echo "Nome: " . $aluna["nome"] . "\n";
echo "E-mail: " . ($aluna["email"] ?? "não informado") . "\n";
echo "Telefone: " . $aluna["telefone"] . "\n";

<?php
$aluna = ["nome" => "Ana", "email" => "ana@exemplo.com"];

echo "Nome: " . $aluna["nome"] . "\n";
echo "E-mail: " . ($aluna["email"] ?? "não informado") . "\n";
echo "Telefone: " . ($aluna["telefone"] ?? "não informado") . "\n";

Por que os parênteses com o .?

O ?? tem prioridade menor que o ponto que junta textos. Sem parênteses, "Telefone: " . $aluna["telefone"] ?? "não informado" é lido como ("Telefone: " . $aluna["telefone"]) ?? "não informado": o PHP junta os textos primeiro (com o Warning) e o resultado, um texto, nunca é null. Então, sempre que o ?? estiver no meio de outros operadores, coloque-o entre parênteses. A aula Precedência mostra esse caso com a saída real.

Encadeando: plano B, plano C…

Dá para colocar vários ?? seguidos. O PHP fica com o primeiro valor que existe e não é null:

<?php
$apelido = null;
$nome = null;
echo $apelido ?? $nome ?? "visitante", "\n";
$nome = "Ana";
echo $apelido ?? $nome ?? "visitante", "\n";

$ php cadeia.php
visitante
Ana

Na primeira vez, o apelido e o nome são null, então sobra "visitante". Na segunda, o apelido continua null, mas o nome vale "Ana", e o PHP para ali.

??, isset e o ternário

Antes do PHP 7.0 não existia ??. O jeito de escrever "valor ou plano B" era com a função isset ("está definido?") e o operador ternário (condição ? se sim : se não, que tem aula própria):

<?php
$apelido = null;
echo isset($apelido) ? $apelido : "sem apelido", "\n";
echo $apelido ?? "sem apelido", "\n";
var_dump(isset($apelido));
var_dump(isset($nome));
$nome = "Ana";
var_dump(isset($nome));

$ php isset.php
sem apelido
sem apelido
bool(false)
bool(false)
bool(true)

isset($apelido)

Responde true se a variável existe e não é null. Aqui, false: ela existe, mas vale null.

? $apelido : "sem apelido"

O ternário: se o isset deu true, usa $apelido; senão, "sem apelido".

$apelido ?? "sem apelido"

Faz exatamente a mesma coisa, e você escreve o nome da variável uma vez só.

Em outras palavras: $a ?? $b é um atalho para isset($a) ? $a : $b. Você ainda vai encontrar a forma longa em código antigo. Em código novo, prefira o ??. Use o isset sozinho quando a pergunta for só "existe?", sem plano B (por exemplo, numa decisão com if).

Cuidado: ?? só se importa com null

O ?? não troca 0, "" (texto vazio) nem false. Esses valores existem e não são null, então o ?? os mantém. Existe outro atalho, o ?: (apelidado de "operador Elvis", porque ?: lembra o topete do cantor), que troca qualquer valor que vale false. Compare:

<?php
$quantidade = 0;
$cupom = "";

var_dump($quantidade ?? 1);
var_dump($quantidade ?: 1);
var_dump($cupom ?? "nenhum");
var_dump($cupom ?: "nenhum");

$ php zero.php
int(0)
int(1)
string(0) ""
string(6) "nenhum"

Se a Ana tem zero itens no carrinho, o ?: "corrigiu" para 1, o que é um erro. O ?? respeitou o zero. E tem mais uma diferença: o ?: mostra o Warning quando a variável não existe:

<?php
echo $sobrenome ?: "sem sobrenome", "\n";

$ php elvis.php

Warning: Undefined variable $sobrenome in /home/ana/site/elvis.php on line 2
sem sobrenome

Qual usar?

??=: preencher só o que está faltando PHP 7.4+

Às vezes você não quer só mostrar um valor padrão, e sim guardá-lo na variável, mas apenas se ela ainda estiver vazia (null ou inexistente). É o ??=, uma atribuição combinada, como +=:

<?php
$tema = null;
$tema ??= "claro";
echo $tema, "\n";

$tema ??= "escuro";
echo $tema, "\n";

$config = ["idioma" => "pt-BR"];
$config["idioma"] ??= "en";
$config["moeda"] ??= "BRL";
print_r($config);

$ php atrib.php
claro
claro
Array
(
    [idioma] => pt-BR
    [moeda] => BRL
)

$tema ??= "claro";

Atalho de $tema = $tema ?? "claro";. Como $tema era null, passou a valer "claro".

$tema ??= "escuro";

$tema já tem valor, então nada muda: continua "claro".

$config["idioma"] ??= "en";

O idioma já existia (pt-BR), ficou como estava.

$config["moeda"] ??= "BRL";

A chave moeda não existia: foi criada com BRL, sem Warning. O print_r mostra o array por dentro (veja var_dump e print_r).

É o jeito ideal de preencher configurações com valores padrão: o que a pessoa escolheu fica; o que ela não escolheu ganha o padrão.

O operador nullsafe ?-> PHP 8.0+

Este operador funciona com objetos, que você vai estudar a fundo no Nível 3 (Classes e Objetos). Por enquanto, basta saber: um objeto é um valor que tem funções próprias, chamadas de métodos, e você chama um método com a seta ->. O PHP já vem com vários objetos prontos; um deles é a data, DateTime, que tem o método format para escrever a data do jeito que você quiser.

A lojinha da Ana guarda a data de entrega de cada pedido. Quando a entrega ainda não foi marcada, a variável vale null. Veja o que acontece:

<?php
$entrega = new DateTime("2026-10-20");
echo $entrega->format("d/m/Y"), "\n";

$entrega = null;
echo $entrega->format("d/m/Y"), "\n";
echo "fim\n";

$ php entrega.php
20/10/2026

Fatal error: Uncaught Error: Call to a member function format() on null in /home/ana/site/entrega.php:6
Stack trace:
#0 {main}
  thrown in /home/ana/site/entrega.php on line 6

Agora não é um simples aviso: é um erro fatal, e o programa parou (o "fim" nunca apareceu). A mensagem diz "chamada a um método format() em null": você pediu para o "nada" se formatar.

O ?-> (seta com interrogação) resolve: se o valor da esquerda for null, ele não chama o método e devolve null. Junto com o ??, vira um plano B completo:

<?php
$entrega = new DateTime("2026-10-20");
var_dump($entrega?->format("d/m/Y"));

$entrega = null;
var_dump($entrega?->format("d/m/Y"));

echo "Entrega: " . ($entrega?->format("d/m/Y") ?? "a combinar"), "\n";

$ php entrega2.php
string(10) "20/10/2026"
NULL
Entrega: a combinar

$entrega

Pode ser um objeto de data ou null.

?->

"Se não for null, chame o método; se for, pare aqui e devolva null."

format("d/m/Y")

O método chamado quando há data: escreve dia/mês/ano.

?? "a combinar"

Se o resultado foi null, usa o plano B.

Na web: $_GET["nome"] ?? "visitante"

Este é o uso mais comum do ?? na vida real. Quando alguém abre ola.php?nome=Ana, o PHP coloca o nome num array especial chamado $_GET. Mas a pessoa pode abrir só ola.php, sem nada, e aí a chave "nome" não existe. A aula $_GET e $_POST explica tudo em detalhes; aqui fica só a ideia.

<?php
$nome = $_GET["nome"] ?? "visitante";
echo "<p>Olá, " . htmlspecialchars($nome) . "!</p>\n";

Testando com o servidor embutido e o curl (que abre a página pelo terminal), com e sem o nome na URL:

$ curl -s "localhost:8000/ola.php?nome=Ana"
<p>Olá, Ana!</p>
$ curl -s localhost:8000/ola.php
<p>Olá, visitante!</p>

Sem o ?? (com $nome = $_GET["nome"];), a página aberta sem o nome mostra os avisos para o visitante, em HTML:

$ curl -s localhost:8000/ola-sem.php
<br />
<b>Warning</b>:  Undefined array key "nome" in <b>/home/ana/site/ola-sem.php</b> on line <b>2</b><br />
<br />
<b>Deprecated</b>:  htmlspecialchars(): Passing null to parameter #1 ($string) of type string is deprecated in <b>/home/ana/site/ola-sem.php</b> on line <b>3</b><br />
<p>Olá, !</p>

O htmlspecialchars está ali por segurança: ele impede que alguém coloque HTML (ou JavaScript) na URL e o seu site o mostre. Veja Escapar a Saída. Experimente: a caixa abaixo funciona como uma página de verdade, aberta no endereço index.php?nome=Ana.

<?php
$nome = $_GET["nome"] ?? "visitante";
echo "<p>Olá, " . htmlspecialchars($nome) . "!</p>\n";

Quando dá errado

$ php entrega.php
20/10/2026

Fatal error: Uncaught Error: Call to a member function format() on null in /home/ana/site/entrega.php:6
Stack trace:
#0 {main}
  thrown in /home/ana/site/entrega.php on line 6

$ php zero.php
int(0)
int(1)
string(0) ""
string(6) "nenhum"

$ php telefone.php
Nome: Ana
E-mail: ana@exemplo.com

Warning: Undefined array key "telefone" in /home/ana/site/telefone.php on line 6
Telefone: 

$ php funcao.php

Warning: Undefined variable $apelido in /home/ana/site/funcao.php on line 2

Deprecated: strtoupper(): Passing null to parameter #1 ($string) of type string is deprecated in /home/ana/site/funcao.php on line 2

Referência

Exercícios

Missão final: a ficha do cliente

<?php
$cliente = ["nome" => "Ana", "cidade" => null];
$apelido = null;

// 1. Use o apelido; se ele for null, use o nome do cliente
echo "Cliente: " . $apelido . "\n";

// 2. Se a cidade for null ou não existir, mostre "não informada"
echo "Cidade: " . $cliente["cidade"] . "\n";

// 3. Se o cliente não tiver país, guarde "Brasil" nele (use ??=)

echo "País: " . $cliente["pais"] . "\n";

<?php
$cliente = ["nome" => "Ana", "cidade" => null];
$apelido = null;

// 1. Use o apelido; se ele for null, use o nome do cliente
echo "Cliente: " . ($apelido ?? $cliente["nome"]) . "\n";

// 2. Se a cidade for null ou não existir, mostre "não informada"
echo "Cidade: " . ($cliente["cidade"] ?? "não informada") . "\n";

// 3. Se o cliente não tiver país, guarde "Brasil" nele (use ??=)
$cliente["pais"] ??= "Brasil";
echo "País: " . $cliente["pais"] . "\n";

Resumo

• $a ?? $b: usa $a se ele existir e não for null; senão, $b. Não mostra Warning para variável ou chave inexistente.
• É o atalho de isset($a) ? $a : $b. Pode ser encadeado: $a ?? $b ?? "padrão".
• O ?? mantém 0, "" e false. Para trocá-los também, existe o ?:, que avisa se a variável não existe.
• $a ??= $b guarda o padrão só no que está faltando.
• $obj?->metodo() PHP 8.0+ devolve null em vez de dar Call to a member function … on null.
• No meio de um texto com ., coloque o ?? entre parênteses.
• Na web: $_GET["nome"] ?? "visitante", sempre com htmlspecialchars na saída.