الدالة isset() في PHP: التحقق من تعيين متغير أو مفتاح

تعيد isset($var) القيمة true إذا كان المتغير موجودًا وقيمته ليست null. وتعيد false لمتغير غير معرّف، أو محذوف بـ unset، أو يحمل null، ولا تطبع أي تحذير أبدًا.

<?php
$name = "Ada";
$age = 0;
$nickname = null;

var_dump(isset($name));       // exists, not null
var_dump(isset($age));        // 0 is still set
var_dump(isset($nickname));   // null counts as not set
var_dump(isset($undefined));  // never assigned

unset($name);
var_dump(isset($name));       // removed with unset()

لا تنظر isset() إلا إلى وجود الشيء. القيمة المعيَّنة لكنها فارغة، مثل 0 أو "" أو []، تعيد true أيضًا. وإذا أردت «معيَّن وغير فارغ»، فاستخدم empty (منفية).

التحقق من وجود مفتاح في مصفوفة باستخدام isset

هنا تُستخدم isset() أكثر ما تُستخدم. قراءة مفتاح غير موجود تطبع Warning: Undefined array key في إعداد PHP عادي، أما فحصه بـ isset() أولًا فلا. وتعمل أيضًا مع المفاتيح المتداخلة، وتتوقف بهدوء عند أول مستوى مفقود.

<?php
$user = [
    "name" => "Grace",
    "email" => "grace@example.com",
    "address" => ["city" => "Arlington"],
    "phone" => null,
];

var_dump(isset($user["email"]));
var_dump(isset($user["website"]));
var_dump(isset($user["address"]["city"]));
var_dump(isset($user["address"]["zip"]));
var_dump(isset($user["company"]["name"]));  // parent key missing too
var_dump(isset($user["phone"]));            // key exists, value is null

if (isset($user["email"])) {
    echo "Send mail to {$user['email']}\n";
}

عندما لا تحتاج إلا إلى القيمة أو قيمة افتراضية، يجري $user["website"] ?? "none" الفحص نفسه في خطوة واحدة. راجع عامل الدمج مع null.

isset مع عدة متغيرات

مرّر عدة وسائط فتعيد isset() القيمة true فقط إذا كانت كلها معيَّنة وليست null. وهي طريقة قصيرة للتحقق من وصول كل الحقول المطلوبة.

<?php
$data = ["first" => "Ada", "last" => "Lovelace", "email" => null];

var_dump(isset($data["first"], $data["last"]));
var_dump(isset($data["first"], $data["email"]));

$required = ["first", "last", "email"];
$missing = array_filter($required, fn($key) => !isset($data[$key]));
echo "Missing: " . implode(", ", $missing) . "\n";

isset على النصوص والكائنات

على النص، تتحقق isset($str[5]) من وجود محرف عند الإزاحة 5، وهذا فحص سريع للطول. وعلى الكائن، تتحقق من خاصية، ولصنف ذي بيانات خاصة تستدعي isset() الدالة __isset() إذا عرّفها الصنف.

<?php
$code = "AB12";
var_dump(isset($code[3]));   // 4th character exists
var_dump(isset($code[4]));   // there is no 5th

class Profile
{
    public ?string $bio = null;
    public string $name = "Linus";
    private array $extra = ["twitter" => "@linus"];

    public function __isset(string $key): bool
    {
        return isset($this->extra[$key]);
    }
}

$p = new Profile();
var_dump(isset($p->name));
var_dump(isset($p->bio));       // null
var_dump(isset($p->twitter));   // answered by __isset()
var_dump(isset($p->github));

isset مقابل empty مقابل is_null

اختر قيمة لـ $x في الجدول لتقارن الفحوص الثلاثة والتحويل البسيط (bool). حُسبت كل خلية بواسطة PHP 8.3.

القاعدة التي يجب تذكّرها:

• تكون isset() مساوية لـ false فقط مع null ومع ما لا وجود له.
• تكون empty() مساوية لـ true مع تلك ومع كل قيمة خاطئة منطقيًا أيضًا: false و0 و0.0 و"" و"0" و[].
• تعطي is_null() عكس isset() للمتغيرات الموجودة، لكنها تحذّر عندما يكون المتغير غير معرّف. استخدم isset() أو === null بدلًا منها.

التحقق من إرسال نموذج

isset() هي الطريقة الكلاسيكية لمعرفة ما إذا وصل حقل من النموذج. شغّل هذا المثال، واكتب اسمًا واضغط Send: يُنفَّذ السكربت نفسه مرة أخرى مع امتلاء $_POST.

<?php
$message = "";
if (isset($_POST["name"])) {
    $name = trim($_POST["name"]);
    $message = $name === ""
        ? "<p style='color:#c33'>Please type a name.</p>"
        : "<p>Hello, " . htmlspecialchars($name) . "</p>";
}
?>
<form method="post">
  <label>Name <input name="name"></label>
  <label><input type="checkbox" name="news" value="1"> Newsletter</label>
  <button>Send</button>
</form>
<?= $message ?>
<?php if (isset($_POST["name"])): ?>
  <p>Newsletter: <?= isset($_POST["news"]) ? "yes" : "no" ?></p>
<?php endif; ?>

حقل النص الفارغ يُرسَل مع ذلك، بقيمة ""، لذا تكون isset($_POST["name"]) مساوية لـ true بعد أي إرسال. أما مربع الاختيار غير المحدد فلا يُرسَل أصلًا، وهذا يجعل isset() الاختبار الصحيح تمامًا لمربعات الاختيار. ولاشتراط قيمة غير فارغة، تحقق من النص بعد تشذيبه كما يفعل المثال. تبني صفحة النماذج نموذجًا كاملًا مع التحقق.

isset مقابل array_key_exists

يتفقان في كل شيء إلا المفتاح الذي قيمته null. تعامله isset() على أنه مفقود، ولا تفعل array_key_exists() ذلك.

<?php
$settings = ["timeout" => 30, "proxy" => null];

foreach (["timeout", "proxy", "retries"] as $key) {
    printf("%-8s isset: %-5s  array_key_exists: %s\n",
        $key,
        var_export(isset($settings[$key]), true),
        var_export(array_key_exists($key, $settings), true));
}

إذا كان «معيَّن إلى null» يعني في بياناتك شيئًا مختلفًا عن «غير مضبوط»، فاستخدم array_key_exists(). وإلا فإن isset() أقصر، وهي بنية لغوية لا استدعاء دالة، لذا فهي أسرع قليلًا أيضًا.

خطأ شائع: isset على تعبير

لا تقبل isset() إلا المتغيرات وعناصر المصفوفات والخصائص. تمرير نتيجة دالة أو ثابت خطأ ترجمة:

<?php
if (isset(trim($input))) {}

PHP Fatal error:  Cannot use isset() on the result of an expression (you can use "null !== expression" instead) in /home/index.php on line 2

خزّن النتيجة في متغير أولًا، أو اختبر القيمة نفسها: null !== $expr كما تقترح الرسالة، أو trim($input) !== "" للنص.