empty() ב-PHP: בדיקת מחרוזות ריקות, מערכים ו-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));
}

trim() לא מקבלת null בלי הודעת deprecation ב-PHP 8.1 ואילך, ולכן הבלוק כותב 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() בלי callback מסירה כל ערך שקרי, ולכן זו דרך מהירה לשאול "האם המערך הזה מכיל משהו אמיתי".

אימות שדה חובה בטופס

!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().