PHP empty() : tester une chaîne vide, un tableau vide et 0

empty($var) renvoie true si la variable n'existe pas ou si sa valeur est évaluée à faux : null, false, 0, 0.0, "", "0" ou un tableau vide []. Pour toute autre valeur, elle renvoie false. Comme isset(), elle n'affiche jamais de warning pour une variable ou une clé de tableau non définie.

<?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) équivaut à !isset($x) || !$x. Autrement dit : absente, ou convertie en false.

Quelles valeurs sont vides

Choisissez une valeur dans le tableau pour voir empty() à côté d'isset() et du cast (bool). Chaque case a été calculée par PHP 8.3.

Les surprises sont aux deux extrémités : "0" est vide, alors que " " (un espace), "0.0", "null" et [0] ne le sont pas.

"0" est vide : le bug classique

Comme "0" est évalué à faux, empty() traite une quantité de 0, un score de 0 ou un code PIN "0" comme « rien de saisi ». Cela pose problème dans les formulaires, où toutes les valeurs arrivent sous forme de chaînes.

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

Pour une saisie texte, le test fiable de « rien de saisi » est trim($value) === "". Gardez empty() pour les valeurs où 0 signifie vraiment rien.

Vérifier si une chaîne est vide

Pour tester exactement une chaîne vide, comparez avec "". Pour traiter aussi les espaces comme du vide, appliquez d'abord trim. Depuis PHP 5.5, empty() accepte des expressions, donc empty(trim($s)) fonctionne aussi (mais avec le même problème de "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() n'accepte pas null sans avis de dépréciation depuis PHP 8.1, c'est pourquoi le bloc écrit trim($s ?? "").

Vérifier si un tableau est vide

Pour les tableaux, empty($arr), $arr === [] et count($arr) === 0 donnent tous la même réponse. empty() a l'avantage de fonctionner sur une variable ou une clé qui n'existe peut-être pas.

<?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() sans callback retire toutes les valeurs évaluées à faux, c'est donc un moyen rapide de demander « ce tableau contient-il quelque chose de réel ».

Valider un champ de formulaire obligatoire

!empty() est une façon courante de rendre un champ obligatoire, tant que 0 n'est pas une réponse valide. Exécutez ce bloc, laissez les champs vides et cliquez sur Send, puis remplissez-les et envoyez à nouveau : le script s'exécute encore une fois avec $_POST rempli.

<?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"]) couvre les deux cas pour la case à cocher : pas envoyée du tout, ou envoyée avec une valeur vide. La page sur les formulaires va plus loin avec des messages d'erreur par champ.

empty ou isset

Les deux sont sûres sur des variables et des clés non définies. Elles répondent à des questions différentes :

<?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) : existe-t-elle et ne vaut-elle pas null ? Utilisez-la pour les clés facultatives, les cases à cocher et « est-ce que cela a été envoyé ».
• !empty($x) : existe-t-elle et est-elle évaluée à vrai ? Utilisez-la pour « contient quelque chose de réel », quand 0 et "0" ne comptent pas.
• $x === "" ou $x === [] : est-elle exactement vide ? Utilisez-la quand 0 est une valeur valide.

La page isset couvre l'autre moitié, y compris isset() sur plusieurs variables à la fois et la différence avec array_key_exists().