array_merge() trong PHP: gộp hai hoặc nhiều mảng

array_merge($a, $b) trả về một mảng mới gồm các phần tử của $a rồi đến các phần tử của $b. Khóa số được đánh số lại từ 0; khi cả hai mảng có cùng một khóa chuỗi, giá trị từ mảng đứng sau sẽ thắng. Bạn có thể truyền bao nhiêu mảng tùy thích.

<?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() không thay đổi các đối số của nó. Hàm trả về mảng đã gộp, nên hãy gán kết quả: $all = array_merge($all, $more);.

Khóa số được đánh số lại

array_merge() coi khóa số nguyên là vị trí chứ không phải tên. Mọi phần tử có khóa số nguyên đều được nối vào cuối và nhận khóa mới bắt đầu từ 0, kể cả khi các mảng dùng cùng những con số hoặc có chỗ bị khuyết. Đó là điều bạn muốn với list, nhưng sẽ gây bất ngờ khi các con số là ID.

<?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

Khóa chuỗi trông giống số nguyên ('101') được lưu dưới dạng số nguyên, nên cũng bị đánh số lại. Khóa như 'id101' thì giữ nguyên.

array_merge vs toán tử +

Toán tử + (hợp mảng) cũng gộp các mảng, nhưng theo quy tắc ngược lại: với khóa nào đã có trong mảng bên trái, giá trị bên trái thắng và giá trị bên phải bị bỏ. Toán tử này không bao giờ đánh số lại. Vì thế + là cách tự nhiên để điền giá trị mặc định, còn array_merge() là cách tự nhiên để ghi đè chúng.

<?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']);

Ví dụ cuối trong khối code là cái bẫy kinh điển của +: ['a', 'b'] + ['x', 'y', 'z'] cho ra a, b, z, vì các khóa 0 và 1 đã có ở bên trái.

Cú pháp spread: [...$a, ...$b]

Toán tử spread mở các mảng ra bên trong một literal mảng. Nó hoạt động giống array_merge(): khóa số nguyên được đánh số lại và, từ PHP 8.1, khóa chuỗi được cho phép và khóa đứng sau thắng. Cú pháp này dễ đọc khi bạn trộn mảng với các giá trị đơn lẻ.

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

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

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

Để nối một mảng vào một mảng có sẵn ngay tại chỗ, xem array_push() với spread operator.

Gộp một mảng chứa các mảng

Khi các mảng cần gộp nằm sẵn trong một list, hãy spread list đó vào array_merge(). Đây cũng là cách nhanh để gộp trong vòng lặp: gom các phần lại, rồi gộp một lần.

<?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 []

Viết $all = array_merge($all, $batch); bên trong vòng lặp vẫn chạy được, nhưng nó sao chép toàn bộ mảng ngày càng lớn ở mỗi lần lặp, và sẽ chậm khi có hàng nghìn phần tử.

array_merge_recursive và array_replace

array_merge_recursive() gộp cả các mảng lồng nhau, nhưng với một khóa chuỗi trùng chứa giá trị thường, nó không ghi đè: nó gom cả hai giá trị vào một mảng mới. Với cấu hình, đó hiếm khi là điều bạn muốn. Trong trường hợp này array_replace_recursive() thường là công cụ đúng: nó ghi đè giá trị ở mọi cấp và giữ nguyên khóa.

<?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

Đọc ba dòng JSON từ trên xuống: array_merge() thay toàn bộ mảng db và làm mất host, array_merge_recursive() biến port và debug thành list hai phần tử, còn array_replace_recursive() cho ra đúng cấu hình bạn muốn.

Lỗi thường gặp: gộp mảng không loại bỏ gì cả

array_merge() giữ các giá trị trùng nhau nằm ở các khóa khác nhau. Gộp hai list tag sẽ khiến mỗi tag chung xuất hiện hai lần. Hãy cho kết quả đi qua array_unique() rồi array_values() để đánh số lại.

<?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";

Trang array_unique trình bày cách loại bỏ phần tử trùng khỏi các hàng dữ liệu và mảng lồng nhau.