PHP empty(): проверка пустой строки, массива и 0

empty($var) возвращает true, если переменной нет или её значение ложно: null, false, 0, 0.0, "", "0" или пустой массив []. Для любого другого значения она возвращает false. Как и isset(), она никогда не предупреждает о неопределённых переменных или ключах массива.

<?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) это то же самое, что !isset($x) || !$x. Иначе говоря: отсутствует или приводится к false.

Какие значения пустые

Выберите значение в таблице, чтобы увидеть empty() рядом с isset() и приведением (bool). Каждую ячейку вычислил PHP 8.3.

Сюрпризы с обеих сторон: "0" пусто, а " " (пробел), "0.0", "null" и [0] нет.

"0" пусто: классическая ошибка

Поскольку "0" ложно, empty() воспринимает количество 0, счёт 0 или PIN "0" как "ничего не введено". Это бьёт по формам, где каждое значение приходит строкой.

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

Для текстового ввода надёжная проверка "ничего не введено" это trim($value) === "". Оставьте empty() для значений, где 0 действительно означает "ничего".

Проверка пустой строки

Чтобы точно проверить пустую строку, сравнивайте с "". Чтобы считать пустыми и одни пробелы, сначала примените trim. Начиная с PHP 5.5 empty() принимает выражения, так что empty(trim($s)) тоже работает (но с той же проблемой "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));
}

В PHP 8.1 и новее trim() не принимает null без уведомления об устаревании, поэтому в блоке написано trim($s ?? "").

Проверка пустого массива

Для массивов empty($arr), $arr === [] и count($arr) === 0 дают одинаковый ответ. Преимущество empty() в том, что она работает с переменной или ключом, которых может не быть.

<?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() без колбэка удаляет все ложные значения, так что это быстрый способ спросить "есть ли в массиве что-то настоящее".

Проверка обязательного поля формы

!empty() часто используют, чтобы сделать поле обязательным, если только 0 не допустимый ответ. Запустите этот блок, оставьте поля пустыми и нажмите Send, затем заполните их и отправьте снова: скрипт выполнится ещё раз с заполненным $_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"]) покрывает для чекбокса оба случая: он не отправлен вовсе или отправлен с пустым значением. На странице о формах разобраны сообщения об ошибках для каждого поля.

empty и isset

Обе безопасны для неопределённых переменных и ключей. Они отвечают на разные вопросы:

<?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): существует ли и не null ли? Для необязательных ключей, чекбоксов и вопроса "было ли это отправлено вообще".
• !empty($x): существует ли и истинно ли? Для вопроса "есть ли что-то настоящее", когда 0 и "0" не в счёт.
• $x === "" или $x === []: точно ли пусто? Когда 0 допустимое значение.

Другая половина описана на странице про isset, включая isset() с несколькими переменными сразу и отличие от array_key_exists().