الدالة 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 دون إشعار إهمال في 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() دون دالة رد نداء كل قيمة خاطئة منطقيًا، لذا فهي طريقة سريعة لسؤال «هل تحتوي هذه المصفوفة على شيء حقيقي».

التحقق من حقل مطلوب في نموذج

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