PHPのempty()：空文字・空配列・0を判定する

empty($var)は、変数が存在しないか、その値がfalseと評価されるもの（null、false、0、0.0、""、"0"、空の配列[]）であればtrueを返します。それ以外の値には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"は空ですが、" "（空白1つ）、"0.0"、"null"、[0]は空ではありません。

"0"は空：定番のバグ

"0"はfalseと評価されるので、empty()は数量の0、得点の0、暗証番号の"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()はfalseと評価される値をすべて取り除くので、「この配列に中身のある値が入っているか」を手早く確かめられます。

必須のフォーム項目を検証する

0が正当な答えでない限り、!empty()は項目を必須にするよく使われる方法です。このブロックを実行し、項目を空のまま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)：存在してtrueと評価されるか。0や"0"を数に入れない「中身があるか」に使います。
• $x === ""や$x === []：ぴったり空か。0が正当な値のときに使います。

もう半分についてはissetのページで、複数の変数を一度に確認するisset()やarray_key_exists()との違いも含めて扱っています。