PHP empty(): comprobar cadenas vacías, arrays y 0

empty($var) devuelve true si la variable no existe o su valor es falsy: null, false, 0, 0.0, "", "0" o un array vacío []. Para cualquier otro valor devuelve false. Igual que isset(), nunca avisa de variables o claves de array no definidas.

<?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) es lo mismo que !isset($x) || !$x. Dicho de otra forma: falta, o se convierte en false.

Qué valores están vacíos

Elige un valor en la tabla para ver empty() junto a isset() y el cast (bool). Cada celda la calculó PHP 8.3.

Las sorpresas están en los dos extremos: "0" está vacío, mientras que " " (un espacio), "0.0", "null" y [0] no lo están.

"0" está vacío: el bug clásico

Como "0" es falsy, empty() trata una cantidad de 0, una puntuación de 0 o un PIN "0" como "no se ha escrito nada". Esto muerde en los formularios, donde todos los valores llegan como cadenas.

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

Para la entrada de texto, la comprobación fiable de "no se ha escrito nada" es trim($value) === "". Deja empty() para los valores en los que 0 realmente significa nada.

Comprobar si una cadena está vacía

Para comprobar exactamente una cadena vacía, compara con "". Para tratar también los espacios como vacío, aplica antes trim. Desde PHP 5.5 empty() acepta expresiones, así que empty(trim($s)) también funciona (pero tiene el mismo problema con "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() no acepta null sin un aviso de obsolescencia desde PHP 8.1, y por eso el bloque escribe trim($s ?? "").

Comprobar si un array está vacío

Con arrays, empty($arr), $arr === [] y count($arr) === 0 dan la misma respuesta. empty() tiene la ventaja de funcionar con una variable o una clave que puede no existir.

<?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() sin callback elimina todos los valores falsy, así que es una forma rápida de preguntar "¿este array contiene algo de verdad?".

Validar un campo de formulario obligatorio

!empty() es una forma habitual de exigir un campo, siempre que 0 no sea una respuesta válida. Ejecuta este bloque, deja los campos en blanco y pulsa Send; después rellénalos y envíalo otra vez: el script se ejecuta de nuevo con $_POST lleno.

<?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"]) cubre los dos casos de la casilla: no enviada en absoluto, o enviada con un valor vacío. La página de formularios va más allá con mensajes de error por campo.

empty vs isset

Las dos son seguras con variables y claves no definidas. Responden a preguntas distintas:

<?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 y no es null? Úsalo para claves opcionales, casillas y "¿se envió esto?".
• !empty($x): ¿existe y es truthy? Úsalo para "tiene algo de verdad", cuando 0 y "0" no cuentan.
• $x === "" o $x === []: ¿está exactamente vacío? Úsalo cuando 0 sea un valor válido.

La página de isset cubre la otra mitad, incluido isset() con varias variables a la vez y la diferencia con array_key_exists().