PHP implode(): Dizi Elemanlarını Bir Dizgede Birleştirme

implode($separator, $array) bir dizinin değerlerini her çiftin arasına $separator koyarak tek bir dizgede birleştirir: implode(', ', ['red', 'green', 'blue']) "red, green, blue" döndürür.

<?php
$colors = ['red', 'green', 'blue'];

echo implode(', ', $colors), "\n";
echo implode(' | ', $colors), "\n";
echo implode('', $colors), "\n";

Ayırıcı yalnızca elemanların arasına gelir, asla ilkinden önce veya sonuncudan sonra değil. Bir dizgeyi diziye bölen explode() fonksiyonunun tersidir.

Söz dizimi

implode(string $separator, array $array): string
implode(array $array): string   // separator defaults to ""

Önce ayırıcı gelir. Eski kodlar bazen diziyi önce verirdi: implode($array, ', '). Bu sıra PHP 7.4'te kullanımdan kaldırıldı ve PHP 8.0'da tamamen silindi; orada TypeError: implode(): Argument #2 ($array) must be of type ?array, string given fırlatır.

implode ile join karşılaştırması

join(), implode() fonksiyonunun bir takma adıdır. Aynı argümanları alır ve aynı dizgeyi döndürürler, bu yüzden birini seçin ve tutarlı kalın.

<?php
$parts = ['2026', '03', '14'];

echo implode('-', $parts), "\n";
echo join('-', $parts), "\n";
var_dump(implode('-', $parts) === join('-', $parts));

Sayılara, boolean değerlere ve null değerine ne olur

Her değer önce bir dizgeye çevrilir. Sayılar beklediğiniz gibi yazdırılır, true "1" olur, false ve null ise boş dizge olur ve art arda iki ayırıcı bırakır.

<?php
$values = [10, 2.5, true, false, null, 'end'];
echo implode(', ', $values), "\n";

// Remove null and false before joining
$clean = array_filter($values, fn($v) => $v !== null && $v !== false);
echo implode(', ', $clean), "\n";

echo '[', implode(', ', []), "]\n";   // an empty array gives an empty string

İlişkisel bir diziyi implode etme

implode() anahtarları yok sayar ve yalnızca değerleri birleştirir. key=value çiftleri elde etmek için her parçayı anahtarlar ve değerler üzerinde array_map() ile oluşturun, sonra birleştirin. http_build_query() bir URL sorgu dizgesi için aynısını yapar ve ayrıca boşlukları ve özel karakterleri kodlar.

<?php
$user = ['name' => 'Ada', 'role' => 'admin', 'city' => 'London'];

echo implode(', ', $user), "\n";   // values only

$pairs = array_map(fn($k, $v) => "$k=$v", array_keys($user), $user);
echo implode(', ', $pairs), "\n";

echo http_build_query(['q' => 'php implode', 'page' => 2]), "\n";

Aynı kalıp yalnızca anahtarları birleştirir: implode(', ', array_keys($user)). Anahtarlar ve değerler hakkında daha fazlası ilişkisel diziler sayfasında.

Yeni satırla birleştirme veya HTML liste oluşturma

Ayırıcı herhangi bir dizge olabilir. "\n" (çift tırnak) her değeri kendi satırına koyar; metin dosyaları ve komut satırı çıktısı için kullanışlıdır. Ayırıcı olarak HTML etiketleriyle implode() tek satırda bir liste oluşturur. Sonraki bloğu çalıştırın, Page sekmesi oluşturulan listeyi gösterir.

<?php
$steps = ['Read the input', 'Validate it', 'Save it'];

$items = array_map('htmlspecialchars', $steps);
echo '<ol><li>' . implode('</li><li>', $items) . '</li></ol>';

Birleştirmeden önce her değeri htmlspecialchars() ile kaçışlamak <b> gibi bir değerin işaretlemeye dönüşmesini önler.

Son öğeden önce "ve" ile birleştirme

İnsanın okuyacağı bir liste genellikle son elemandan önce "ve" ister. Onu çıkarın, geri kalanı birleştirin, sonra geri ekleyin:

<?php
function humanList(array $items): string
{
    if (count($items) <= 1) {
        return implode('', $items);
    }
    $last = array_pop($items);
    return implode(', ', $items) . ' and ' . $last;
}

echo humanList(['PHP']), "\n";
echo humanList(['PHP', 'Python']), "\n";
echo humanList(['PHP', 'Python', 'Go', 'Rust']), "\n";

Sık yapılan hata: iç içe diziler

implode() tek seviyede çalışır. Kendisi dizi olan bir eleman Array kelimesine çevrilir ve PHP bir uyarı yazdırır:

<?php
echo implode(', ', ['red', ['orange', 'yellow']]);

Warning: Array to string conversion in /home/index.php on line 2
red, Array

İç dizileri önce düzleştirin ya da her birini ayrı ayrı birleştirin:

<?php
$groups = [
    'warm' => ['red', 'orange'],
    'cool' => ['blue', 'green'],
];

// Join each inner array, then join the results
$lines = array_map(fn($colors) => implode(', ', $colors), $groups);
echo implode("\n", $lines), "\n";

// Or flatten everything into one list
echo implode(', ', array_merge(...array_values($groups))), "\n";