PHP empty(): puste łańcuchy, tablice i 0

empty($var) zwraca true, jeśli zmienna nie istnieje albo jej wartość jest fałszywa: null, false, 0, 0.0, "", "0" lub pusta tablica []. Dla każdej innej wartości zwraca false. Podobnie jak isset() nigdy nie ostrzega o niezdefiniowanych zmiennych ani kluczach tablic.

<?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) to to samo co !isset($x) || !$x. Innymi słowy: brakuje jej albo konwertuje się na false.

Które wartości są puste

Wybierz wartość w tabeli, aby zobaczyć empty() obok isset() i rzutowania (bool). Każdą komórkę obliczyło PHP 8.3.

Niespodzianki są na obu końcach: "0" jest puste, a " " (spacja), "0.0", "null" i [0] nie są.

"0" jest puste: klasyczny błąd

Ponieważ "0" jest fałszywe, empty() traktuje ilość 0, wynik 0 albo PIN "0" jak „nic nie wpisano”. To daje się we znaki w formularzach, gdzie każda wartość przychodzi jako łańcuch.

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

Dla danych tekstowych niezawodnym sprawdzeniem „nic nie wpisano” jest trim($value) === "". Zostaw empty() dla wartości, w których 0 naprawdę oznacza nic.

Sprawdzanie, czy łańcuch jest pusty

Aby dokładnie sprawdzić pusty łańcuch, porównaj z "". Aby traktować też białe znaki jako puste, najpierw użyj trim. Od PHP 5.5 empty() przyjmuje wyrażenia, więc empty(trim($s)) też działa (ale ma ten sam problem z "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));
}

W PHP 8.1 i nowszych trim() nie przyjmuje null bez komunikatu o przestarzałym użyciu, dlatego blok pisze trim($s ?? "").

Sprawdzanie, czy tablica jest pusta

Dla tablic empty($arr), $arr === [] i count($arr) === 0 dają tę samą odpowiedź. Zaletą empty() jest to, że działa na zmiennej lub kluczu, które mogą nie istnieć.

<?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() bez callbacku usuwa każdą wartość fałszywą, więc to szybki sposób, by zapytać „czy ta tablica zawiera coś prawdziwego”.

Walidacja wymaganego pola formularza

!empty() to częsty sposób wymagania pola, o ile 0 nie jest poprawną odpowiedzią. Uruchom ten blok, zostaw pola puste i kliknij Send, potem je wypełnij i wyślij ponownie: skrypt wykona się jeszcze raz z wypełnionym $_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"]) obejmuje oba przypadki dla checkboxa: w ogóle niewysłany albo wysłany z pustą wartością. Strona o formularzach idzie dalej, z komunikatami błędów dla każdego pola.

empty vs isset

Obie konstrukcje są bezpieczne na niezdefiniowanych zmiennych i kluczach. Odpowiadają na różne pytania:

<?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): czy istnieje i nie jest null? Używaj dla opcjonalnych kluczy, checkboxów i „czy to w ogóle wysłano”.
• !empty($x): czy istnieje i jest prawdziwe? Używaj dla „ma coś prawdziwego”, gdy 0 i "0" się nie liczą.
• $x === "" albo $x === []: czy jest dokładnie puste? Używaj, gdy 0 jest poprawną wartością.

Strona o isset opisuje drugą połowę, łącznie z isset() dla kilku zmiennych naraz i różnicą względem array_key_exists().