PHP isset(): verificare se una variabile o chiave esiste

isset($var) restituisce true se la variabile esiste e il suo valore non è null. Restituisce false per una variabile non definita, rimossa con unset o che contiene null, e non stampa mai un warning.

<?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() guarda solo se qualcosa c'è. Un valore impostato ma vuoto, come 0, "" o [], restituisce comunque true. Se ti serve "impostato e non vuoto", usa empty (negato).

Verificare se una chiave di array esiste con isset

È qui che isset() si usa di più. Leggere una chiave che non esiste stampa Warning: Undefined array key con una normale configurazione di PHP; controllarla prima con isset() no. Funziona anche con le chiavi annidate e si ferma in silenzio al primo livello mancante.

<?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 ti servono solo il valore o un default, $user["website"] ?? "none" fa lo stesso controllo in un passo. Vedi l'operatore null coalescing.

isset con più variabili

Passa più argomenti e isset() restituisce true solo se sono tutti impostati e non null. È un modo breve per verificare che ogni campo obbligatorio sia arrivato.

<?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 su stringhe e oggetti

Su una stringa, isset($str[5]) controlla se c'è un carattere all'offset 5, il che è un rapido controllo della lunghezza. Su un oggetto, controlla una proprietà; per una classe con dati privati, isset() chiama il metodo __isset() se la classe lo definisce.

<?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 vs empty vs is_null

Scegli un valore di $x nella tabella per confrontare i tre controlli e il semplice cast (bool). Ogni cella è stata calcolata da PHP 8.3.

Lo schema da ricordare:

• isset() è false solo per null e per ciò che non esiste.
• empty() è true per questi e anche per ogni valore falsy: false, 0, 0.0, "", "0", [].
• is_null() dà l'opposto di isset() per le variabili esistenti, ma genera un warning quando la variabile non è definita. Usa invece isset() o === null.

Verificare se un form è stato inviato

isset() è il modo classico per vedere se un campo di un form è arrivato. Esegui questo blocco, scrivi un nome e premi Send: lo stesso script viene eseguito di nuovo con $_POST compilato.

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

Un campo di testo vuoto viene comunque inviato, come "", quindi isset($_POST["name"]) è true dopo qualsiasi invio. Una checkbox non selezionata non viene inviata affatto, il che rende isset() il test giusto per le checkbox. Per richiedere un valore non vuoto, controlla la stringa dopo il trim come fa il blocco. La pagina sui form costruisce un form completo con la validazione.

isset vs array_key_exists

I due concordano su tutto tranne una chiave il cui valore è null. isset() la tratta come mancante, array_key_exists() no.

<?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 nei tuoi dati "impostato a null" significa qualcosa di diverso da "non configurato", usa array_key_exists(). Altrimenti isset() è più breve, ed essendo un costrutto del linguaggio e non una chiamata di funzione è anche un po' più veloce.

Errore comune: isset su un'espressione

isset() accetta solo variabili, elementi di array e proprietà. Passargli il risultato di una funzione o una costante è un errore di compilazione:

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

Salva prima il risultato in una variabile, oppure verifica direttamente il valore: null !== $expr come suggerisce il messaggio, o trim($input) !== "" per una stringa.