الدالة in_array() في PHP: هل القيمة موجودة في المصفوفة؟

تعيد in_array($needle, $haystack) القيمة true إذا كانت القيمة في مكان ما من المصفوفة وfalse إن لم تكن. مرّر true وسيطًا ثالثًا، in_array($needle, $haystack, true)، لتشترط النوع نفسه أيضًا؛ وهذه الصيغة الصارمة هي التي ينبغي استخدامها افتراضيًا.

<?php
$roles = ['admin', 'editor', 'viewer'];

var_dump(in_array('editor', $roles));
var_dump(in_array('owner', $roles));

if (in_array('admin', $roles, true)) {
    echo "Show the admin menu\n";
}

لا تنظر in_array() إلا إلى القيم. للتحقق من وجود مفتاح، استخدم array_key_exists() أو isset().

الوسيط strict

دون الوسيط الثالث، تقارن in_array() بـ ==، التي تحوّل الأنواع قبل المقارنة. ومع true، تقارن بـ ===: يجب أن تتطابق القيمة والنوع معًا. ويظهر الفرق حالما تجمع المصفوفة بين أعداد ونصوص، وهذا شائع مع بيانات النماذج والروابط وملفات CSV.

<?php
$ids = [1, 2, 3];

var_dump(in_array('2', $ids));          // loose: "2" == 2
var_dump(in_array('2', $ids, true));    // strict: string is not int

$flags = [0, 'off'];
var_dump(in_array(null, $flags));       // null == 0
var_dump(in_array(null, $flags, true));

var_dump(in_array(true, ['yes']));      // 'yes' is truthy, so == true
var_dump(in_array('1e1', ['10']));      // both numeric: 10 == 10

كل خلية أدناه هي ما تعيده == و=== لذلك الزوج من القيم في PHP 8.3. تجيب in_array() بـ true إذا أعطت القيمة المبحوث عنها وأي عنصر النتيجة true في الجدول للوضع الذي تستخدمه. بدّل بين التبويبات وانظر إلى صفوف null وtrue والنصوص الرقمية.

تغيّرت قاعدة واحدة في PHP 8: النص غير الرقمي لم يعد يساوي 0، لذا فإن in_array('abc', [0]) تساوي false اليوم لكنها كانت true في PHP 7. اعتمدت شيفرات كُتبت لـ PHP 7 على ذلك أحيانًا، وهذا سبب آخر لتمرير true وعدم الاعتماد على قواعد التحويل. تشرحها صفحة عوامل المقارنة كاملة.

in_array دون حساسية لحالة الأحرف

تقارن in_array() النصوص حرفيًا، لذا فإن 'PHP' و'php' مختلفتان. حوّل القيمة المبحوث عنها والمصفوفة إلى أحرف صغيرة قبل الفحص. وتتعامل mb_strtolower() مع الحروف ذات العلامات وغير اللاتينية أيضًا.

<?php
$allowed = ['jpg', 'PNG', 'Gif'];
$ext = 'png';

var_dump(in_array($ext, $allowed, true));

$lower = array_map('strtolower', $allowed);
var_dump(in_array(strtolower($ext), $lower, true));

$cities = ['München', 'Zürich'];
var_dump(in_array('ZÜRICH', $cities, true));
var_dump(in_array(mb_strtolower('ZÜRICH'), array_map('mb_strtolower', $cities), true));

فحص عدة قيم معًا

تأخذ in_array() قيمة بحث واحدة. ولعدة قيم، قارن المصفوفات على أنها مجموعات: تعيد array_diff() القيم المفقودة، فالنتيجة الفارغة تعني أن كلها موجودة، وتعيد array_intersect() القيم التي وُجدت.

<?php
$skills = ['php', 'sql', 'git', 'docker'];

$required = ['php', 'git'];
$hasAll = array_diff($required, $skills) === [];
var_dump($hasAll);

$wanted = ['rust', 'sql'];
$hasAny = array_intersect($wanted, $skills) !== [];
var_dump($hasAny);

print_r(array_diff(['php', 'go'], $skills));   // what is missing

تقارن array_diff() وarray_intersect() القيم على أنها نصوص، لذا يُعدّ 1 و'1' متساويين هناك.

in_array على مصفوفة متعددة الأبعاد

لا تبحث in_array() داخل المصفوفات المتداخلة. للتحقق من أن أي صف يحتوي حقلًا بقيمة معينة، استخرج ذلك الحقل أولًا بـ array_column()، ثم ابحث في القائمة المسطحة.

<?php
$users = [
    ['id' => 1, 'email' => 'ada@example.com'],
    ['id' => 2, 'email' => 'linus@example.com'],
];

var_dump(in_array('ada@example.com', $users, true));    // compares whole rows

$emails = array_column($users, 'email');
var_dump(in_array('ada@example.com', $emails, true));

var_dump(in_array(['id' => 2, 'email' => 'linus@example.com'], $users, true));

يبيّن السطر الأخير أن القيمة المبحوث عنها يمكن أن تكون مصفوفة: فتطابق صفًا مماثلًا تمامًا، بالمفاتيح والقيم والترتيب نفسها.

in_array مقابل array_search مقابل isset

الثلاثة تجيب عن «هل هي موجودة؟»، لكنها تعيد أشياء مختلفة وتعمل بسرعات مختلفة:

استخدم array_search() عندما تحتاج إلى معرفة مكان القيمة. وعندما تفحص قيمًا كثيرة مقابل القائمة الكبيرة نفسها، اقلب القائمة مرة واحدة لتصبح قيمها مفاتيح، واستخدم isset().

<?php
$banned = [];
for ($i = 0; $i < 100000; $i++) {
    $banned[] = "user$i";
}
$checks = ['user99999', 'guest', 'user5'];

$start = hrtime(true);
for ($n = 0; $n < 200; $n++) {
    foreach ($checks as $name) {
        in_array($name, $banned, true);
    }
}
printf("in_array: %.1f ms\n", (hrtime(true) - $start) / 1e6);

$set = array_flip($banned);        // values become keys, done once
$start = hrtime(true);
for ($n = 0; $n < 200; $n++) {
    foreach ($checks as $name) {
        isset($set[$name]);
    }
}
printf("isset:    %.1f ms\n", (hrtime(true) - $start) / 1e6);

var_dump(isset($set['user5']), isset($set['guest']));

تتغير الأزمنة من تشغيل لآخر، لكن الفجوة لا تتغير: يبقى بحث isset() ثابتًا بينما يكبر in_array() مع حجم القائمة. لا تعمل array_flip() إلا مع القيم النصية والصحيحة، وتندمج التكرارات في مفتاح واحد، وهذا لا يهم في فحص العضوية.