PHP isset(): verificar se variável ou chave existe

isset($var) retorna true se a variável existe e o valor dela não é null. Ele retorna false para uma variável indefinida, removida com unset ou que guarda null, e nunca imprime aviso.

<?php
$name = "Ada";
$age = 0;
$nickname = null;

var_dump(isset($name));       // exists, not null
var_dump(isset($age));        // 0 is still set
var_dump(isset($nickname));   // null counts as not set
var_dump(isset($undefined));  // never assigned

unset($name);
var_dump(isset($name));       // removed with unset()

isset() só olha se algo está lá. Um valor definido mas vazio, como 0, "" ou [], ainda retorna true. Se você quer "definido e não vazio", use empty (negado).

Verificar se uma chave de array existe com isset

É aqui que o isset() é mais usado. Ler uma chave que não existe imprime Warning: Undefined array key numa configuração normal do PHP; verificar antes com isset() não imprime. Também funciona com chaves aninhadas e para em silêncio no primeiro nível ausente.

<?php
$user = [
    "name" => "Grace",
    "email" => "grace@example.com",
    "address" => ["city" => "Arlington"],
    "phone" => null,
];

var_dump(isset($user["email"]));
var_dump(isset($user["website"]));
var_dump(isset($user["address"]["city"]));
var_dump(isset($user["address"]["zip"]));
var_dump(isset($user["company"]["name"]));  // parent key missing too
var_dump(isset($user["phone"]));            // key exists, value is null

if (isset($user["email"])) {
    echo "Send mail to {$user['email']}\n";
}

Quando você só precisa do valor ou de um padrão, $user["website"] ?? "none" faz a mesma verificação num passo. Veja o operador de coalescência nula.

isset com várias variáveis

Passe vários argumentos e o isset() retorna true só se todos estiverem definidos e não forem null. É um jeito curto de verificar que todos os campos obrigatórios chegaram.

<?php
$data = ["first" => "Ada", "last" => "Lovelace", "email" => null];

var_dump(isset($data["first"], $data["last"]));
var_dump(isset($data["first"], $data["email"]));

$required = ["first", "last", "email"];
$missing = array_filter($required, fn($key) => !isset($data[$key]));
echo "Missing: " . implode(", ", $missing) . "\n";

isset em strings e objetos

Numa string, isset($str[5]) verifica se existe um caractere no offset 5, o que é uma verificação rápida de tamanho. Num objeto, verifica uma propriedade; para uma classe com dados privados, o isset() chama o método __isset() se a classe o definir.

<?php
$code = "AB12";
var_dump(isset($code[3]));   // 4th character exists
var_dump(isset($code[4]));   // there is no 5th

class Profile
{
    public ?string $bio = null;
    public string $name = "Linus";
    private array $extra = ["twitter" => "@linus"];

    public function __isset(string $key): bool
    {
        return isset($this->extra[$key]);
    }
}

$p = new Profile();
var_dump(isset($p->name));
var_dump(isset($p->bio));       // null
var_dump(isset($p->twitter));   // answered by __isset()
var_dump(isset($p->github));

isset, empty e is_null

Escolha um valor de $x na tabela para comparar as três verificações e o cast (bool) simples. Cada célula foi calculada pelo PHP 8.3.

O padrão para lembrar:

• isset() é false só para null e para coisas que não existem.
• empty() é true para esses casos e também para todo valor falso: false, 0, 0.0, "", "0", [].
• is_null() dá o oposto de isset() para variáveis existentes, mas avisa quando a variável é indefinida. Use isset() ou === null no lugar.

Verificar se um formulário foi enviado

isset() é o jeito clássico de ver se um campo do formulário chegou. Rode este bloco, digite um nome e clique em Send: o mesmo script roda de novo com $_POST preenchido.

<?php
$message = "";
if (isset($_POST["name"])) {
    $name = trim($_POST["name"]);
    $message = $name === ""
        ? "<p style='color:#c33'>Please type a name.</p>"
        : "<p>Hello, " . htmlspecialchars($name) . "</p>";
}
?>
<form method="post">
  <label>Name <input name="name"></label>
  <label><input type="checkbox" name="news" value="1"> Newsletter</label>
  <button>Send</button>
</form>
<?= $message ?>
<?php if (isset($_POST["name"])): ?>
  <p>Newsletter: <?= isset($_POST["news"]) ? "yes" : "no" ?></p>
<?php endif; ?>

Um campo de texto vazio ainda é enviado, como "", então isset($_POST["name"]) é true depois de qualquer envio. Um checkbox desmarcado não é enviado, o que torna o isset() exatamente o teste certo para checkboxes. Para exigir um valor não vazio, verifique a string com trim como o bloco faz. A página sobre formulários monta um formulário completo com validação.

isset ou array_key_exists

Os dois concordam em tudo, exceto numa chave cujo valor é null. isset() a trata como ausente, array_key_exists() não.

<?php
$settings = ["timeout" => 30, "proxy" => null];

foreach (["timeout", "proxy", "retries"] as $key) {
    printf("%-8s isset: %-5s  array_key_exists: %s\n",
        $key,
        var_export(isset($settings[$key]), true),
        var_export(array_key_exists($key, $settings), true));
}

Se "definido como null" significa algo diferente de "não configurado" nos seus dados, use array_key_exists(). Caso contrário, isset() é mais curto e, por ser uma construção da linguagem e não uma chamada de função, também é um pouco mais rápido.

Erro comum: isset numa expressão

isset() só aceita variáveis, elementos de array e propriedades. Passar o resultado de uma função ou uma constante é um erro de compilação:

<?php
if (isset(trim($input))) {}

PHP Fatal error:  Cannot use isset() on the result of an expression (you can use "null !== expression" instead) in /home/index.php on line 2

Guarde o resultado numa variável antes, ou teste o próprio valor: null !== $expr, como a mensagem sugere, ou trim($input) !== "" para uma string.