PHP isset() : vérifier une variable ou une clé de tableau

isset($var) renvoie true si la variable existe et que sa valeur ne vaut pas null. Elle renvoie false pour une variable non définie, supprimée avec unset ou contenant null, et n'affiche jamais de 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() regarde seulement si quelque chose est présent. Une valeur définie mais vide, comme 0, "" ou [], renvoie quand même true. Si vous voulez « définie et non vide », utilisez empty (inversée).

Vérifier si une clé de tableau existe avec isset

C'est l'usage le plus courant de isset(). Lire une clé qui n'existe pas affiche Warning: Undefined array key sur une configuration PHP normale ; la vérifier d'abord avec isset() n'affiche rien. Cela fonctionne aussi pour les clés imbriquées, et s'arrête sans bruit au premier niveau manquant.

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

Quand vous avez seulement besoin de la valeur ou d'une valeur par défaut, $user["website"] ?? "none" fait la même vérification en une étape. Voir l'opérateur de fusion null.

isset avec plusieurs variables

Passez plusieurs arguments et isset() ne renvoie true que si tous sont définis et différents de null. C'est une façon courte de vérifier que chaque champ obligatoire est arrivé.

<?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 sur des chaînes et des objets

Sur une chaîne, isset($str[5]) vérifie s'il y a un caractère à la position 5, ce qui permet de vérifier rapidement une longueur. Sur un objet, elle vérifie une propriété ; pour une classe aux données privées, isset() appelle la méthode __isset() si la classe en définit une.

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

Choisissez une valeur de $x dans le tableau pour comparer les trois vérifications et le simple cast (bool). Chaque case a été calculée par PHP 8.3.

Le principe à retenir :

• isset() vaut false seulement pour null et pour ce qui n'existe pas.
• empty() vaut true pour ces cas et aussi pour toute valeur évaluée à faux : false, 0, 0.0, "", "0", [].
• is_null() donne l'inverse de isset() pour les variables existantes, mais affiche un warning quand la variable n'est pas définie. Utilisez plutôt isset() ou === null.

Vérifier si un formulaire a été envoyé

isset() est la façon classique de savoir si un champ de formulaire est arrivé. Exécutez ce bloc, tapez un nom et cliquez sur Send : le même script s'exécute à nouveau avec $_POST rempli.

<?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 champ texte vide est quand même envoyé, sous la forme "", donc isset($_POST["name"]) vaut true après n'importe quel envoi. Une case à cocher non cochée n'est pas envoyée du tout, ce qui fait de isset() le test exact pour les cases à cocher. Pour exiger une valeur non vide, vérifiez la chaîne après trim comme le fait le bloc. La page sur les formulaires construit un formulaire complet avec validation.

isset ou array_key_exists

Les deux sont d'accord sur tout sauf sur une clé dont la valeur est null. isset() la considère comme absente, pas array_key_exists().

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

Si « défini à null » signifie autre chose que « non configuré » dans vos données, utilisez array_key_exists(). Sinon isset() est plus court, et c'est une construction du langage plutôt qu'un appel de fonction, donc un peu plus rapide.

Erreur fréquente : isset sur une expression

isset() n'accepte que des variables, des éléments de tableau et des propriétés. Lui passer le résultat d'une fonction ou une constante est une erreur de compilation :

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

Stockez d'abord le résultat dans une variable, ou testez la valeur elle-même : null !== $expr comme le suggère le message, ou trim($input) !== "" pour une chaîne.