PHP empty(): leere Strings, Arrays und 0 prüfen

empty($var) liefert true, wenn die Variable nicht existiert oder ihr Wert falsy ist: null, false, 0, 0.0, "", "0" oder ein leeres Array []. Für jeden anderen Wert liefert es false. Wie isset() warnt es nie bei undefinierten Variablen oder Array-Schlüsseln.

<?php
$name = "";
$items = [];
$count = 0;
$city = "Paris";

var_dump(empty($name));
var_dump(empty($items));
var_dump(empty($count));
var_dump(empty($city));
var_dump(empty($notDefined));

if (empty($items)) {
    echo "Your cart is empty\n";
}

empty($x) entspricht !isset($x) || !$x. Anders gesagt: fehlt, oder wird zu false.

Welche Werte leer sind

Wähle in der Tabelle einen Wert, um empty() neben isset() und dem Cast (bool) zu sehen. Jede Zelle wurde von PHP 8.3 berechnet.

Die Überraschungen liegen an beiden Enden: "0" ist leer, während " " (ein Leerzeichen), "0.0", "null" und [0] es nicht sind.

"0" ist leer: der klassische Bug

Weil "0" falsy ist, behandelt empty() eine Menge von 0, eine Punktzahl von 0 oder eine PIN "0" als „nichts eingegeben“. Das trifft dich bei Formularen, wo jeder Wert als String ankommt.

<?php
$submitted = ["quantity" => "0", "comment" => "", "pin" => "0"];

foreach ($submitted as $field => $value) {
    $byEmpty = empty($value) ? "missing" : "ok";
    $byString = trim($value) === "" ? "missing" : "ok";
    printf("%-9s %-4s empty(): %-8s trim() === '': %s\n",
        $field, var_export($value, true), $byEmpty, $byString);
}

Bei Texteingaben ist die zuverlässige Prüfung auf „nichts eingegeben“ trim($value) === "". Behalte empty() für Werte, bei denen 0 wirklich nichts bedeutet.

Prüfen, ob ein String leer ist

Um genau auf einen leeren String zu testen, vergleichst du mit "". Um auch Leerraum als leer zu behandeln, rufst du vorher trim auf. Seit PHP 5.5 akzeptiert empty() Ausdrücke, also funktioniert auch empty(trim($s)) (hat aber dasselbe Problem mit "0").

<?php
$tests = ["", "   ", "0", "hello", null];

foreach ($tests as $s) {
    printf("%-8s === '': %-5s  trim === '': %-5s  empty(): %s\n",
        var_export($s, true),
        var_export($s === "", true),
        var_export(trim($s ?? "") === "", true),
        var_export(empty($s), true));
}

trim() akzeptiert ab PHP 8.1 kein null ohne Deprecation-Hinweis, deshalb schreibt der Block trim($s ?? "").

Prüfen, ob ein Array leer ist

Bei Arrays liefern empty($arr), $arr === [] und count($arr) === 0 alle dieselbe Antwort. empty() hat den Vorteil, dass es auch bei einer Variable oder einem Schlüssel funktioniert, die vielleicht nicht existieren.

<?php
$cart = [];
$tags = ["php"];
$order = ["lines" => []];

var_dump(empty($cart), $cart === [], count($cart) === 0);
var_dump(empty($tags));
var_dump(empty($order["lines"]));
var_dump(empty($order["discounts"]));   // key not there at all

// An array of empty values is not empty
var_dump(empty(["", null, 0]));

// To ignore blank entries, filter first
var_dump(empty(array_filter(["", null, 0])));

array_filter() ohne Callback entfernt jeden falsy Wert und ist damit eine schnelle Art zu fragen, „ob dieses Array etwas Echtes enthält“.

Ein Pflichtfeld im Formular prüfen

!empty() ist ein üblicher Weg, ein Feld zur Pflicht zu machen, solange 0 keine gültige Antwort ist. Führe diesen Block aus, lass die Felder leer und klicke auf Send, füll sie dann aus und sende erneut: Das Skript läuft noch einmal, mit gefülltem $_POST.

<?php
$errors = [];
$sent = ($_SERVER["REQUEST_METHOD"] ?? "GET") === "POST";

if ($sent) {
    if (empty($_POST["email"])) {
        $errors[] = "Email is required.";
    }
    if (empty($_POST["terms"])) {
        $errors[] = "Please accept the terms.";
    }
    // Age 0 is invalid anyway, but "" must be caught: here empty() fits
    if (empty($_POST["age"]) || !ctype_digit($_POST["age"])) {
        $errors[] = "Age must be a whole number.";
    }
}
?>
<form method="post">
  <p><label>Email <input name="email" value="<?= htmlspecialchars($_POST["email"] ?? "") ?>"></label></p>
  <p><label>Age <input name="age" value="<?= htmlspecialchars($_POST["age"] ?? "") ?>"></label></p>
  <p><label><input type="checkbox" name="terms" value="1" <?= empty($_POST["terms"]) ? "" : "checked" ?>> I accept the terms</label></p>
  <button>Send</button>
</form>
<?php if ($sent && !$errors): ?>
  <p style="color:#0a7">Thanks, all fields are valid.</p>
<?php endif; ?>
<?php foreach ($errors as $e): ?>
  <p style="color:#c33"><?= $e ?></p>
<?php endforeach; ?>

empty($_POST["terms"]) deckt bei der Checkbox beide Fälle ab: gar nicht gesendet oder mit leerem Wert gesendet. Die Seite zu Formularen geht mit Fehlermeldungen pro Feld weiter.

empty vs isset

Beide sind bei undefinierten Variablen und Schlüsseln sicher. Sie beantworten verschiedene Fragen:

<?php
$values = ["null" => null, "zero" => 0, "zero string" => "0", "empty string" => "", "space" => " ", "text" => "php"];

printf("%-13s %-7s %-7s %s\n", "", "isset", "empty", "!empty");
foreach ($values as $label => $v) {
    printf("%-13s %-7s %-7s %s\n", $label,
        var_export(isset($v), true),
        var_export(empty($v), true),
        var_export(!empty($v), true));
}

• isset($x): Existiert es und ist es nicht null? Verwende es für optionale Schlüssel, Checkboxen und „wurde das überhaupt gesendet“.
• !empty($x): Existiert es und ist es truthy? Verwende es für „hat etwas Echtes“, wenn 0 und "0" nicht zählen.
• $x === "" oder $x === []: Ist es genau leer? Verwende es, wenn 0 ein gültiger Wert ist.

Die Seite zu isset behandelt die andere Hälfte, einschließlich isset() mit mehreren Variablen auf einmal und dem Unterschied zu array_key_exists().