PHP array_merge(): İki veya Daha Fazla Diziyi Birleştirme

array_merge($a, $b) $a elemanlarını ve ardından $b elemanlarını içeren yeni bir dizi döndürür. Sayısal anahtarlar 0'dan yeniden numaralanır; iki dizide aynı dizge anahtar varsa sonraki dizideki değer kazanır. İstediğiniz kadar dizi verebilirsiniz.

<?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() argümanlarını değiştirmez. Birleştirilmiş diziyi döndürür, bu yüzden sonucu atayın: $all = array_merge($all, $more);.

Sayısal anahtarlar yeniden numaralanır

array_merge() tam sayı anahtarları isim olarak değil konum olarak görür. Tam sayı anahtarlı her eleman sona eklenir ve diziler aynı sayıları ya da boşlukları kullanmış olsa bile 0'dan yeni bir anahtar alır. Listeler için istediğiniz budur; sayılar ID olduğunda ise bir sürprizdir.

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

Tam sayıya benzeyen dizge anahtarlar ('101') tam sayı olarak saklanır, bu yüzden onlar da yeniden numaralanır. 'id101' gibi anahtarlar olduğu gibi kalır.

array_merge ile + operatörü karşılaştırması

+ operatörü (dizi birleşimi) de dizileri birleştirir, ama ters kuralla: soldaki dizide zaten var olan her anahtar için soldaki değer kazanır ve sağdaki atılır. Asla yeniden numaralamaz. Bu da + operatörünü varsayılanları doldurmanın, array_merge() fonksiyonunu ise onları geçersiz kılmanın doğal yolu yapar.

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

Bloktaki son örnek klasik + tuzağıdır: ['a', 'b'] + ['x', 'y', 'z'] a, b, z verir, çünkü 0 ve 1 anahtarları solda zaten vardır.

Açma söz dizimi: [...$a, ...$b]

Açma (spread) operatörü dizileri bir dizi değişmezinin içinde açar. array_merge() gibi davranır: tam sayı anahtarlar yeniden numaralanır ve PHP 8.1'den beri dizge anahtarlara izin verilir, sonraki kazanır. Dizileri tekil değerlerle karıştırdığınızda iyi okunur.

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

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

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

Bir diziyi var olan bir diziye yerinde eklemek için açma operatörüyle array_push() sayfasına bakın.

Dizilerden oluşan bir diziyi birleştirme

Birleştirilecek diziler bir listenin içindeyse o listeyi array_merge() içine açın. Bu aynı zamanda bir döngü içinde birleştirmenin hızlı yoludur: parçaları toplayın, sonra bir kez birleştirin.

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

Döngü içinde $all = array_merge($all, $batch); yazmak çalışır, ama her turda büyüyen dizinin tamamını kopyalar ve binlerce elemanla yavaşlar.

array_merge_recursive ve array_replace

array_merge_recursive() iç içe dizileri de birleştirir, ama düz değerler tutan tekrarlanan bir dizge anahtarda üzerine yazmaz: iki değeri yeni bir dizide toplar. Yapılandırma için istenen bu nadiren olur. Orada genellikle doğru araç array_replace_recursive() fonksiyonudur: her seviyede değerlerin üzerine yazar ve anahtarları korur.

<?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 satırını yukarıdan aşağıya okuyun: array_merge() tüm db dizisini değiştirdi ve host kayboldu, array_merge_recursive() port ve debug değerlerini iki elemanlı listelere çevirdi, array_replace_recursive() ise kastettiğiniz yapılandırmayı üretti.

Sık yapılan hata: birleştirme hiçbir şeyi silmez

array_merge() farklı anahtarlar altında duran tekrarlanan değerleri korur. İki etiket listesini birleştirmek her ortak etiketi iki kez verir. Sonucu array_unique() ve ardından yeniden numaralamak için array_values() içinden geçirin.

<?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 sayfası satırlardan ve iç içe dizilerden tekrarları kaldırmayı anlatır.