PHPのimplode()：配列の要素を連結して文字列にする

implode($separator, $array)は、配列の値を各ペアの間に$separatorを挟んで1つの文字列につなぎます：implode(', ', ['red', 'green', 'blue'])は"red, green, blue"を返します。

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

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

区切り文字は要素の間にだけ入り、最初の要素の前や最後の要素のあとには決して入りません。文字列を配列に分割するexplode()の逆の処理です。

構文

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

区切り文字が先です。古いコードでは、配列を先に渡していることがあります（implode($array, ', ')）。この順番はPHP 7.4で非推奨になり、PHP 8.0で削除されたので、TypeError: implode(): Argument #2 ($array) must be of type ?array, string givenが投げられます。

implodeとjoinの違い

join()はimplode()の別名です。同じ引数を受け取り、同じ文字列を返すので、どちらかを選んで統一しましょう。

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

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

数値、真偽値、nullはどうなるか

各値はまず文字列に変換されます。数値は予想どおりに出力され、trueは"1"に、falseとnullは空文字列になるので、区切り文字が2つ続いて残ります。

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

連想配列をimplodeする

implode()はキーを無視して値だけをつなぎます。key=valueのペアにするには、array_map()でキーと値から各部分を作ってからつなぎます。http_build_query()はURLのクエリ文字列に対して同じことを行い、空白や特殊文字のエンコードもします。

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

同じパターンでキーだけをつなぐこともできます：implode(', ', array_keys($user))。キーと値については連想配列のページで詳しく説明しています。

改行でつなぐ、HTMLのリストを作る

区切り文字にはどんな文字列でも使えます。"\n"（ダブルクォート）なら各値が1行ずつになり、テキストファイルやコマンドラインの出力に便利です。HTMLタグを区切り文字にすれば、implode()でリストを1行で作れます。次のブロックを実行すると、Pageタブに描画されたリストが表示されます。

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

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

つなぐ前に各値をhtmlspecialchars()でエスケープしておけば、<b>のような値がマークアップになることはありません。

最後の項目の前に"and"を付けてつなぐ

人が読むリストでは、たいてい最後の要素の前に"and"が必要です。最後の要素を取り出し、残りをつないでから、最後に足します。

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

よくあるミス：ネストした配列

implode()は1つの階層しか扱いません。それ自体が配列である要素はArrayという単語に変換され、PHPは警告を表示します。

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

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

内側の配列を先に平らにするか、それぞれを別々につなぎます。

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