الدالة array_merge() في PHP: دمج مصفوفتين أو أكثر

تعيد array_merge($a, $b) مصفوفة جديدة فيها عناصر $a تليها عناصر $b. يُعاد ترقيم المفاتيح الرقمية من 0؛ وعندما يكون للمصفوفتين المفتاح النصي نفسه، تفوز القيمة من المصفوفة اللاحقة. مرّر عددًا من المصفوفات كما تشاء.

<?php
$fruits = ['apple', 'pear'];
$veg    = ['carrot', 'leek'];
print_r(array_merge($fruits, $veg));

$defaults = ['color' => 'blue', 'size' => 'M'];
$chosen   = ['size' => 'L'];
print_r(array_merge($defaults, $chosen));   // later value wins

لا تغيّر array_merge() وسائطها. بل تعيد المصفوفة المدموجة، فأسند النتيجة: $all = array_merge($all, $more);.

يُعاد ترقيم المفاتيح الرقمية

تعامل array_merge() المفاتيح الصحيحة على أنها مواضع، لا أسماء. يُلحق كل عنصر ذي مفتاح صحيح ويحصل على مفتاح جديد من 0، حتى لو استخدمت المصفوفات الأرقام نفسها أو كانت فيها فجوات. وهذا ما تريده للقوائم، ومفاجأة عندما تكون الأرقام معرّفات.

<?php
$a = [5 => 'Ada', 9 => 'Linus'];
$b = [5 => 'Grace'];

print_r(array_merge($a, $b));   // keys 0, 1, 2: the IDs are gone

$usersById = [101 => 'Ada', 102 => 'Linus'];
$more      = [103 => 'Grace'];
print_r($usersById + $more);    // + keeps the integer keys

المفاتيح النصية التي تشبه أعدادًا صحيحة ('101') تُخزَّن أعدادًا صحيحة، لذا يُعاد ترقيمها أيضًا. أما مفاتيح مثل 'id101' فتبقى كما هي.

array_merge مقابل العامل +

يجمع العامل + (اتحاد المصفوفات) المصفوفات أيضًا، لكن بالقاعدة المعاكسة: لأي مفتاح موجود أصلًا في المصفوفة الأولى، تفوز قيمتها وتُسقط القيمة الأخرى. ولا يعيد الترقيم أبدًا. وهذا يجعل + الطريقة الطبيعية لملء القيم الافتراضية، وarray_merge() الطريقة الطبيعية لتجاوزها.

<?php
$defaults = ['theme' => 'light', 'lang' => 'en', 'per_page' => 20];
$user     = ['theme' => 'dark'];

print_r(array_merge($defaults, $user));   // user overrides defaults
print_r($user + $defaults);               // same result: user is on the left

// With lists, + compares positions and drops duplicates by key
print_r(['a', 'b'] + ['x', 'y', 'z']);

المثال الأخير في الكتلة هو فخ + الكلاسيكي: تعطي ['a', 'b'] + ['x', 'y', 'z'] النتيجة a, b, z، لأن المفتاحين 0 و1 موجودان أصلًا في المصفوفة الأولى.

صيغة البسط: [...$a, ...$b]

يفك عامل البسط المصفوفات داخل مصفوفة حرفية. ويتصرف مثل array_merge(): يُعاد ترقيم المفاتيح الصحيحة، ومنذ PHP 8.1 تُسمح المفاتيح النصية ويفوز اللاحق منها. وتُقرأ جيدًا عندما تمزج مصفوفات بقيم مفردة.

<?php
$first  = [1, 2];
$second = [3, 4];

print_r([...$first, ...$second, 5]);

$base  = ['host' => 'localhost', 'port' => 3306];
$local = ['port' => 3307];
print_r([...$base, ...$local]);

لإلحاق مصفوفة بمصفوفة موجودة في مكانها، راجع array_push() مع عامل البسط.

دمج مصفوفة من المصفوفات

عندما تكون المصفوفات المراد جمعها نفسها في قائمة، ابسط تلك القائمة في array_merge(). وهذه أيضًا الطريقة السريعة للدمج داخل حلقة: اجمع الأجزاء، ثم ادمج مرة واحدة.

<?php
$pages = [
    ['ada', 'linus'],
    ['grace'],
    ['margaret', 'alan'],
];

$all = array_merge(...$pages);
print_r($all);

$batches = [];
for ($page = 1; $page <= 3; $page++) {
    $batches[] = range($page * 10, $page * 10 + 2);   // pretend API page
}
echo implode(', ', array_merge(...$batches)), "\n";

var_dump(array_merge(...[]));   // an empty list gives []

كتابة $all = array_merge($all, $batch); داخل الحلقة تعمل، لكنها تنسخ المصفوفة المتنامية كلها في كل دورة، فتصبح بطيئة مع آلاف العناصر.

array_merge_recursive وarray_replace

تدمج array_merge_recursive() المصفوفات المتداخلة أيضًا، لكن مع مفتاح نصي مكرر يحمل قيمًا بسيطة لا تستبدل: بل تجمع القيمتين في مصفوفة جديدة. ونادرًا ما يكون هذا ما تريده للإعدادات. وعادة ما تكون array_replace_recursive() الأداة الصحيحة هناك: تستبدل القيم في كل مستوى وتحتفظ بالمفاتيح.

<?php
$defaults = ['db' => ['host' => 'localhost', 'port' => 3306], 'debug' => false];
$override = ['db' => ['port' => 3307], 'debug' => true];

echo json_encode(array_merge($defaults, $override)), "\n";
echo json_encode(array_merge_recursive($defaults, $override)), "\n";
echo json_encode(array_replace_recursive($defaults, $override)), "\n";

print_r(array_replace([5 => 'a', 9 => 'b'], [9 => 'B']));   // keeps integer keys

اقرأ أسطر JSON الثلاثة من الأعلى إلى الأسفل: استبدلت array_merge() مصفوفة db كلها وضيّعت host، وحوّلت array_merge_recursive() كلًّا من port وdebug إلى قائمتين من عنصرين، وأنتجت array_replace_recursive() الإعدادات التي قصدتها.

خطأ شائع: الدمج لا يحذف شيئًا

تُبقي array_merge() القيم المكررة الموجودة تحت مفاتيح مختلفة. دمج قائمتين من الوسوم يعطيك كل وسم مشترك مرتين. مرّر النتيجة عبر array_unique() ثم array_values() لإعادة ترقيمها.

<?php
$postTags  = ['php', 'arrays', 'beginner'];
$extraTags = ['arrays', 'tutorial', 'php'];

$merged = array_merge($postTags, $extraTags);
echo implode(', ', $merged), "\n";

$unique = array_values(array_unique($merged));
echo implode(', ', $unique), "\n";

تشرح صفحة array_unique حذف التكرارات من الصفوف والمصفوفات المتداخلة.