PHP array_merge(): Menggabungkan Dua Array atau Lebih

array_merge($a, $b) mengembalikan array baru berisi elemen-elemen $a lalu diikuti elemen-elemen $b. Key numerik dinomori ulang mulai dari 0; saat kedua array punya key string yang sama, nilai dari array yang belakangan yang menang. Kamu bisa memberikan array sebanyak yang kamu mau.

<?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() tidak mengubah argumennya. Fungsi ini mengembalikan array gabungan, jadi simpan hasilnya: $all = array_merge($all, $more);.

Key numerik dinomori ulang

array_merge() memperlakukan key integer sebagai posisi, bukan sebagai nama. Setiap elemen dengan key integer ditambahkan di akhir dan mendapat key baru mulai dari 0, bahkan kalau array-array itu memakai angka yang sama atau punya celah. Itulah yang kamu mau untuk list, tetapi mengejutkan kalau angkanya berupa 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

Key string yang terlihat seperti integer ('101') disimpan sebagai integer, jadi key itu juga dinomori ulang. Key seperti 'id101' tetap seperti semula.

array_merge vs operator +

Operator + (union array) juga menggabungkan array, tetapi dengan aturan kebalikannya: untuk key yang sudah ada di array kiri, nilai kiri yang menang dan nilai kanan dibuang. Operator ini tidak pernah menomori ulang. Karena itu + adalah cara alami untuk mengisi nilai bawaan, dan array_merge() adalah cara alami untuk menimpanya.

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

Contoh terakhir di blok tadi adalah jebakan klasik +: ['a', 'b'] + ['x', 'y', 'z'] menghasilkan a, b, z, karena key 0 dan 1 sudah ada di sebelah kiri.

Sintaks spread: [...$a, ...$b]

Spread operator membongkar array di dalam literal array. Perilakunya seperti array_merge(): key integer dinomori ulang, dan sejak PHP 8.1 key string diperbolehkan dan yang belakangan yang menang. Sintaks ini enak dibaca saat kamu mencampur array dengan nilai tunggal.

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

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

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

Untuk menambahkan sebuah array ke array yang sudah ada secara langsung, lihat array_push() dengan spread operator.

Menggabungkan array berisi array

Kalau array-array yang ingin digabung berada di dalam sebuah list, spread list itu ke dalam array_merge(). Ini juga cara cepat untuk menggabungkan di dalam loop: kumpulkan potongannya, lalu gabungkan sekali.

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

Menulis $all = array_merge($all, $batch); di dalam loop memang berhasil, tetapi seluruh array yang terus membesar disalin di setiap putaran, dan itu jadi lambat dengan ribuan item.

array_merge_recursive dan array_replace

array_merge_recursive() juga menggabungkan array bersarang, tetapi untuk key string yang sama dengan nilai biasa, fungsi ini tidak menimpa: kedua nilainya dikumpulkan ke dalam array baru. Itu jarang sesuai keinginanmu untuk konfigurasi. Di situ, array_replace_recursive() biasanya alat yang tepat: fungsi ini menimpa nilai di setiap level dan mempertahankan key.

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

Baca ketiga baris JSON itu dari atas ke bawah: array_merge() mengganti seluruh array db dan kehilangan host, array_merge_recursive() mengubah port dan debug menjadi list berisi dua elemen, dan array_replace_recursive() menghasilkan konfigurasi yang kamu maksud.

Kesalahan umum: penggabungan tidak menghapus apa pun

array_merge() tetap menyimpan nilai duplikat yang berada di key berbeda. Menggabungkan dua list tag membuat setiap tag yang sama muncul dua kali. Lewatkan hasilnya ke array_unique(), lalu array_values() untuk menomorinya ulang.

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

Halaman array_unique membahas cara menghapus duplikat dari baris data dan array bersarang.