الدالة array_key_exists() في PHP: هل المفتاح موجود؟

تعيد array_key_exists('key', $array) القيمة true إذا كانت المصفوفة تحتوي ذلك المفتاح وfalse إذا لم تكن. لاحظ الترتيب: المفتاح أولًا، والمصفوفة ثانيًا. وتعيد true حتى عندما تكون القيمة المخزنة تحت المفتاح null، وهذا هو الشيء الوحيد الذي لا تفعله isset().

<?php
$user = ['name' => 'Ada', 'email' => 'ada@example.com', 'phone' => null];

var_dump(array_key_exists('email', $user));
var_dump(array_key_exists('address', $user));
var_dump(array_key_exists('phone', $user));   // key is there, value is null

$list = ['a', 'b', 'c'];
var_dump(array_key_exists(2, $list));         // integer keys too

للتحقق من قيمة بدل مفتاح، استخدم in_array().

array_key_exists مقابل isset

كلتاهما تتحقق من مفتاح. ولا تختلفان إلا عندما تكون القيمة null: تعامل isset() القيمة null على أنها «غير معيّنة»، وتبلّغ array_key_exists() عمّا في المصفوفة فعلًا.

<?php
$form = ['name' => 'Ada', 'nickname' => null, 'age' => 0, 'bio' => ''];

foreach (['name', 'nickname', 'age', 'bio', 'missing'] as $key) {
    printf(
        "%-9s isset: %-5s  array_key_exists: %s\n",
        $key,
        var_export(isset($form[$key]), true),
        var_export(array_key_exists($key, $form), true)
    );
}

يُعدّ 0 و'' معيّنين لكلتيهما؛ ولا يفرّق بينهما إلا null. وأيهما تريد يعتمد على معنى null في بياناتك:

• استخدم isset() عندما تعني null «لا قيمة». وهي الحالة الشائعة، وهي بنية لغوية (أسرع قليلًا)، وتقبل المسارات المتداخلة والمتغيرات غير المعرّفة دون تحذير.
• استخدم array_key_exists() عندما تكون null قيمة حقيقية يجب أن تميّزها عن مفتاح مفقود: حقل JSON أُرسل على أنه null، أو عمود قاعدة بيانات قيمته NULL، أو خيار ضُبط صراحة على null لمسحه.

تشرح صفحة isset استخداماتها الأخرى، بما فيها فحص عدة متغيرات معًا.

التمييز بين null والمفقود في حمولة JSON

حالة نموذجية لا تعطي فيها الإجابة الصحيحة إلا array_key_exists(): واجهة برمجية تحدّث سجلًا من JSON. الحقل المرسل على أنه null يعني «امسحه»، والحقل المحذوف يعني «لا تلمسه». وترى isset() الحالتين شيئًا واحدًا.

<?php
$record = ['name' => 'Ada', 'phone' => '555-0100', 'city' => 'London'];
$patch  = json_decode('{"phone": null, "city": "Paris"}', true);

foreach (['name', 'phone', 'city'] as $field) {
    if (array_key_exists($field, $patch)) {
        $record[$field] = $patch[$field];   // includes setting null
    }
}

var_dump($record);

مع isset($patch[$field]) سيبقى رقم الهاتف، لأن null ستبدو حقلًا مفقودًا.

key_exists() هي الدالة نفسها

key_exists() اسم بديل لـ array_key_exists()، بقي من PHP المبكرة. الوسائط نفسها والنتيجة نفسها. فضّل الاسم الكامل، فهو ما يتوقع القراء رؤيته.

<?php
$config = ['debug' => false];

var_dump(key_exists('debug', $config));
var_dump(array_key_exists('debug', $config));
var_dump(key_exists('cache', $config));

أنواع المفاتيح: "1" و1 مفتاح واحد

مفاتيح المصفوفة أعداد صحيحة أو نصوص، والنص الذي هو عدد عشري صحيح بسيط يُخزَّن عددًا صحيحًا. لذا تجد array_key_exists('1', $arr) المفتاح 1، والعكس صحيح. أما نص مثل '01' فيبقى نصًا وهو مفتاح مختلف.

<?php
$byId = [1 => 'Ada', 2 => 'Linus', '07' => 'Grace'];

var_dump(array_key_exists('1', $byId));    // "1" is the int key 1
var_dump(array_key_exists(7, $byId));      // 7 is not "07"
var_dump(array_key_exists('07', $byId));

فحص المفاتيح المتداخلة وعدة مفاتيح

تنظر array_key_exists() إلى مستوى واحد. لمسار متداخل لا تهم فيه null، تفحص isset($a['x']['y']) كل المستويات مرة واحدة. ولمسار تهم فيه، تمشي دالة مساعدة قصيرة على المستويات. وللتحقق من وجود عدة مفاتيح كلها، قارن بـ array_diff_key().

<?php
function hasPath(array $data, array $path): bool
{
    foreach ($path as $key) {
        if (!is_array($data) || !array_key_exists($key, $data)) {
            return false;
        }
        $data = $data[$key];
    }
    return true;
}

$order = ['customer' => ['address' => ['city' => 'Lyon', 'zip' => null]]];

var_dump(isset($order['customer']['address']['zip']));          // null: false
var_dump(hasPath($order, ['customer', 'address', 'zip']));       // present: true
var_dump(hasPath($order, ['customer', 'phone']));

$required = ['name', 'email', 'password'];
$input = ['name' => 'Ada', 'email' => 'ada@example.com'];
$missing = array_keys(array_diff_key(array_flip($required), $input));
print_r($missing);

تحوّل array_flip($required) قائمة الأسماء إلى مفاتيح لتتمكن array_diff_key() من مقارنتها بمفاتيح المُدخلات؛ وما يتبقى هو قائمة الحقول المفقودة، جاهزة لرسالة خطأ.

الكائنات تحتاج إلى property_exists

كانت PHP الأقدم تقبل كائنًا في array_key_exists(). أما PHP 8 فترمي TypeError بدلًا من ذلك. للكائنات، تتحقق property_exists() من خاصية معرّفة أو ديناميكية (حتى لو كانت مضبوطة على null)، وتعمل isset($obj->prop) مثل isset() على المصفوفات.

<?php
class User
{
    public ?string $phone = null;
    public string $name = 'Ada';
}

$u = new User();

var_dump(property_exists($u, 'phone'));   // declared, value null
var_dump(isset($u->phone));
var_dump(property_exists($u, 'email'));

$asArray = get_object_vars($u);
var_dump(array_key_exists('name', $asArray));

يبيّن السطران الأخيران الطريق الآخر: تحوّل get_object_vars() خصائص الكائن المتاحة إلى مصفوفة، وعندها تنطبق دوال المصفوفات.