Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

isset: existe e não é null

isset verifica se uma variável ou um elemento selecionado existe e tem um valor diferente de null. Não distingue uma chave ausente de uma chave que contém null.

Versão: PHP 8.4

Sintaxe

isset($var, ...$vars): bool

isset($value) é falso para uma variável não definida e para null. É verdadeiro para 0, false e uma cadeia vazia. Não é, por isso, um teste do valor lógico, de conteúdo não vazio ou da validade dos dados.

Num array, isset($data["nickname"]) também verifica uma chave ausente sem emitir um aviso. Para distinguir uma chave ausente de um valor null guardado explicitamente, usa array_key_exists. No exemplo, a chave nickname existe, mas contém null.

Com vários argumentos, todos têm de existir e ser diferentes de null. A verificação para na primeira condição não satisfeita. isset é uma construção da linguagem: aceita variáveis em vez de expressões arbitrárias e não suporta argumentos com nome.

Um resultado verdadeiro não confirma o tipo, as permissões ou a segurança do conteúdo. Em objetos, verificar uma propriedade inacessível pode chamar __isset se esse método estiver definido. Não pressuponhas que todas estas verificações são apenas uma simples leitura de um campo.

Exemplos

<?php
declare(strict_types=1);

$data = ["nickname" => null, "score" => 0, "active" => false];
var_export(isset($data["nickname"])); echo "\n";
var_export(array_key_exists("nickname", $data)); echo "\n";
var_export(isset($data["score"], $data["active"])); echo "\n";
var_export(isset($data["missing"])); echo "\n";

Resultado

false
true
true
false

Fontes