PHP isset(): prüfen, ob Variable oder Schlüssel gesetzt ist

isset($var) liefert true, wenn die Variable existiert und ihr Wert nicht null ist. Es liefert false für eine undefinierte Variable, eine mit unset entfernte oder eine, die null enthält, und gibt nie eine Warnung aus.

<?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() schaut nur, ob etwas da ist. Ein Wert, der gesetzt, aber leer ist, etwa 0, "" oder [], liefert trotzdem true. Wenn du „gesetzt und nicht leer“ willst, verwende empty (negiert).

Mit isset prüfen, ob ein Array-Schlüssel existiert

Dafür wird isset() am häufigsten verwendet. Einen nicht existierenden Schlüssel zu lesen, gibt in einer normalen PHP-Umgebung Warning: Undefined array key aus; ihn vorher mit isset() zu prüfen nicht. Es funktioniert auch für verschachtelte Schlüssel und hält still bei der ersten fehlenden Ebene an.

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

Wenn du nur den Wert oder einen Standardwert brauchst, macht $user["website"] ?? "none" dieselbe Prüfung in einem Schritt. Siehe den Null-Coalescing-Operator.

isset mit mehreren Variablen

Übergib mehrere Argumente, und isset() liefert nur dann true, wenn alle gesetzt und nicht null sind. So prüfst du kurz, ob jedes Pflichtfeld angekommen ist.

<?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 bei Strings und Objekten

Bei einem String prüft isset($str[5]), ob an Offset 5 ein Zeichen steht, also eine schnelle Längenprüfung. Bei einem Objekt prüft es eine Eigenschaft; bei einer Klasse mit privaten Daten ruft isset() die Methode __isset() auf, wenn die Klasse eine definiert.

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

Wähle in der Tabelle einen Wert für $x, um die drei Prüfungen und den einfachen Cast (bool) zu vergleichen. Jede Zelle wurde von PHP 8.3 berechnet.

Das Muster zum Merken:

• isset() ist nur bei null und bei Dingen, die nicht existieren, false.
• empty() ist bei diesen true und außerdem bei jedem falsy Wert: false, 0, 0.0, "", "0", [].
• is_null() liefert bei existierenden Variablen das Gegenteil von isset(), warnt aber, wenn die Variable undefiniert ist. Verwende stattdessen isset() oder === null.

Prüfen, ob ein Formular abgeschickt wurde

isset() ist der klassische Weg, um zu sehen, ob ein Formularfeld angekommen ist. Führe diesen Block aus, tippe einen Namen ein und klicke auf Send: Dasselbe Skript läuft erneut, mit gefülltem $_POST.

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

Ein leeres Textfeld wird trotzdem gesendet, als "", also ist isset($_POST["name"]) nach jedem Absenden true. Eine nicht angehakte Checkbox wird gar nicht gesendet, und deshalb ist isset() genau der richtige Test für Checkboxen. Um einen nicht leeren Wert zu verlangen, prüfst du den getrimmten String, wie der Block es tut. Die Seite zu Formularen baut ein vollständiges Formular mit Validierung.

isset vs array_key_exists

Die beiden stimmen in allem überein, außer bei einem Schlüssel mit dem Wert null. isset() behandelt ihn als fehlend, array_key_exists() nicht.

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

Wenn „auf null gesetzt“ in deinen Daten etwas anderes bedeutet als „nicht konfiguriert“, verwende array_key_exists(). Sonst ist isset() kürzer, und weil es ein Sprachkonstrukt und kein Funktionsaufruf ist, auch etwas schneller.

Typischer Fehler: isset auf einen Ausdruck

isset() akzeptiert nur Variablen, Array-Elemente und Eigenschaften. Ein Funktionsergebnis oder eine Konstante zu übergeben ist ein Compile-Fehler:

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

Speichere das Ergebnis zuerst in einer Variable oder prüfe den Wert selbst: null !== $expr, wie die Meldung vorschlägt, oder trim($input) !== "" bei einem String.