الدالة array_unique() في PHP: حذف القيم المكررة

تعيد array_unique($array) المصفوفة بعد حذف القيم المكررة. يبقى أول ظهور لكل قيمة، تحت مفتاحه الأصلي، وتُسقط النسخ اللاحقة.

<?php
$tags = ["php", "arrays", "php", "tips", "arrays", "php"];

$unique = array_unique($tags);
print_r($unique);

print_r(array_values($unique)); // renumbered 0, 1, 2

تحتفظ النتيجة الأولى بالمفاتيح 0, 1, 3: المواضع التي ظهرت فيها كل قيمة أول مرة. ضع الاستدعاء داخل array_values() عندما تريد قائمة نظيفة، مثلًا قبل json_encode.

كيف تقرر array_unique أن قيمتين متماثلتان

افتراضيًا تُحوَّل كل قيمة إلى نص وتُقارن النصوص. لذا تُعدّ 1 و"1" و1.0 القيمة نفسها، ويفوز أولها. ويغيّر الوسيط الثاني طريقة المقارنة.

<?php
$mixed = [1, "1", 1.0, true, "01", 2];

var_dump(array_unique($mixed));                // compared as strings
var_dump(array_unique($mixed, SORT_REGULAR));  // compared with ==
var_dump(array_unique(["10", "1e1", "010"], SORT_NUMERIC));

مع الافتراضي، تبقى "01" لأن النص "01" ليس النص "1". ومع SORT_REGULAR تُسقط، لأن "01" == 1 صحيحة. وتسمح المقارنة المرنة أيضًا للقيمة المنطقية true بأن تطابق أي قيمة غير فارغة. افحص المخرجات قبل الاعتماد عليها مع أنواع مختلطة؛ تشرح صفحة عوامل المقارنة القواعد.

حذف التكرارات متجاهلًا حالة الأحرف

array_unique حساسة لحالة الأحرف: "PHP" و"php" مختلفتان. لمعاملتهما مكررتين مع الإبقاء على الكتابة الأصلية لأولاهما، جد المفاتيح الفريدة على نسخة بأحرف صغيرة واحتفظ بتلك المفاتيح من الأصل.

<?php
$languages = ["PHP", "Python", "php", "Go", "python", "GO", "Rust"];

$keys = array_unique(array_map('strtolower', $languages));
$result = array_values(array_intersect_key($languages, $keys));

print_r($result);

تبني array_map نسخة بأحرف صغيرة بالمفاتيح نفسها، وتُبقي array_unique مفاتيح الظهور الأول، وتلتقط array_intersect_key تلك المفاتيح من المصفوفة الأصلية. وللنصوص ذات العلامات أو اليابانية، استخدم mb_strtolower بدل strtolower.

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

دون علم، تحوّل array_unique كل صف إلى النص "Array"، فتبدو كل الصفوف متطابقة ولا يبقى إلا الأول، مع تحذير "Array to string conversion" لكل صف. مرّر SORT_REGULAR لمقارنة الصفوف كاملة. وللإبقاء على صف واحد لكل قيمة من حقل واحد، تكون array_column مع null ومفتاح فهرس أبسط.

<?php
$signups = [
    ["email" => "ada@example.com", "plan" => "free"],
    ["email" => "bob@example.com", "plan" => "pro"],
    ["email" => "ada@example.com", "plan" => "free"],
    ["email" => "ada@example.com", "plan" => "pro"],
];

// Exact duplicate rows removed
print_r(array_unique($signups, SORT_REGULAR));

// One row per email: the last row for each email wins
print_r(array_values(array_column($signups, null, 'email')));

يُبقي الأسلوب الثاني آخر صف لكل بريد لأن كل صف لاحق يستبدل السابق تحت المفتاح نفسه. وتشرح صفحة array_column مفتاح الفهرس بالتفصيل.

إيجاد القيم المكررة وعدّها

تعيد array_count_values() عدد مرات ظهور كل قيمة. صفِّ ذلك للأعداد الأكبر من واحد فتحصل على التكرارات.

<?php
$votes = ["red", "blue", "red", "green", "blue", "red"];

$counts = array_count_values($votes);
print_r($counts);

$duplicates = array_keys(array_filter($counts, fn($n) => $n > 1));
echo "Duplicated: " . implode(", ", $duplicates) . "\n";

echo count($votes) === count(array_unique($votes))
    ? "No duplicates\n"
    : "Has duplicates\n";

الفحص الأخير سطر شائع لاختبار ما إذا كان في المصفوفة أي تكرار أصلًا.

قيم فريدة أسرع للمصفوفات الكبيرة

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

<?php
$ids = [];
for ($i = 0; $i < 200000; $i++) {
    $ids[] = $i % 1000;
}

$start = hrtime(true);
$a = array_unique($ids);
$t1 = (hrtime(true) - $start) / 1e6;

$start = hrtime(true);
$b = array_keys(array_flip($ids));
$t2 = (hrtime(true) - $start) / 1e6;

echo count($a), " unique values with array_unique\n";
echo count($b), " unique values with array_keys(array_flip())\n";
printf("array_unique: %.1f ms, array_flip: %.1f ms\n", $t1, $t2);

تتغير الأزمنة من تشغيل لآخر، لكن نسخة القلب عادة أسرع بعدة مرات. ولا تعمل إلا مع القيم التي يمكن أن تكون مفاتيح مصفوفة (الأعداد الصحيحة والنصوص)، وتعود النصوص الرقمية مثل "5" أعدادًا صحيحة.