PHP empty(): stringhe vuote, array vuoti e 0

empty($var) restituisce true se la variabile non esiste o se il suo valore è falsy: null, false, 0, 0.0, "", "0" o un array vuoto []. Per qualsiasi altro valore restituisce false. Come isset(), non genera mai warning per variabili o chiavi di array non definite.

<?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) equivale a !isset($x) || !$x. In altre parole: manca, oppure si converte in false.

Quali valori sono vuoti

Scegli un valore nella tabella per vedere empty() accanto a isset() e al cast (bool). Ogni cella è stata calcolata da PHP 8.3.

Le sorprese sono ai due estremi: "0" è vuoto, mentre " " (uno spazio), "0.0", "null" e [0] non lo sono.

"0" è vuoto: il bug classico

Dato che "0" è falsy, empty() tratta una quantità 0, un punteggio 0 o un PIN "0" come "nessun valore inserito". Succede spesso nei form, dove ogni valore arriva come stringa.

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

Per l'input testuale, il controllo affidabile per "nessun valore inserito" è trim($value) === "". Tieni empty() per i valori in cui 0 significa davvero niente.

Verificare se una stringa è vuota

Per verificare esattamente una stringa vuota, confronta con "". Per considerare vuoti anche gli spazi, applica prima trim. Da PHP 5.5 empty() accetta espressioni, quindi funziona anche empty(trim($s)) (ma con lo stesso problema di "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));
}

Da PHP 8.1 trim() non accetta null senza un avviso di deprecazione, ed è per questo che il blocco scrive trim($s ?? "").

Verificare se un array è vuoto

Per gli array, empty($arr), $arr === [] e count($arr) === 0 danno tutti la stessa risposta. empty() ha il vantaggio di funzionare su una variabile o una chiave che potrebbe non esistere.

<?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() senza callback rimuove ogni valore falsy, quindi è un modo rapido per chiedere "questo array contiene qualcosa di concreto".

Validare un campo obbligatorio di un form

!empty() è un modo comune per rendere obbligatorio un campo, purché 0 non sia una risposta valida. Esegui questo blocco, lascia vuoti i campi e premi Send, poi compilali e invia di nuovo: lo script viene eseguito ancora con $_POST compilato.

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

Per la checkbox empty($_POST["terms"]) copre entrambi i casi: non inviata affatto, oppure inviata con un valore vuoto. La pagina sui form va oltre con messaggi di errore per ogni campo.

empty vs isset

Entrambi sono sicuri su variabili e chiavi non definite. Rispondono a domande diverse:

<?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): esiste e non è null? Usalo per chiavi facoltative, checkbox e "è stato inviato o no".
• !empty($x): esiste ed è truthy? Usalo per "contiene qualcosa di concreto", quando 0 e "0" non contano.
• $x === "" o $x === []: è esattamente vuoto? Usalo quando 0 è un valore valido.

La pagina su isset copre l'altra metà, compreso isset() con più variabili insieme e la differenza da array_key_exists().