PHP implode(): Array-Elemente zu einem String verbinden

implode($separator, $array) verbindet die Werte eines Arrays zu einem String, mit $separator zwischen je zwei Werten: implode(', ', ['red', 'green', 'blue']) liefert "red, green, blue".

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

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

Das Trennzeichen kommt nur zwischen Elemente, nie vor das erste oder hinter das letzte. Es ist die Umkehrung von explode(), das einen String in ein Array teilt.

Syntax

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

Das Trennzeichen kommt zuerst. Älterer Code hat manchmal das Array zuerst übergeben, implode($array, ', '). Diese Reihenfolge wurde in PHP 7.4 als veraltet markiert und in PHP 8.0 entfernt, wo sie TypeError: implode(): Argument #2 ($array) must be of type ?array, string given wirft.

implode vs join

join() ist ein Alias von implode(). Sie nehmen dieselben Argumente und liefern denselben String, also wähl eines und bleib dabei.

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

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

Was mit Zahlen, Booleans und null passiert

Jeder Wert wird zuerst in einen String umgewandelt. Zahlen erscheinen wie erwartet, true wird zu "1", und false und null werden zu leeren Strings, was zwei Trennzeichen hintereinander hinterlässt.

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

Ein assoziatives Array verbinden

implode() ignoriert Schlüssel und verbindet nur die Werte. Um Paare key=value zu bekommen, baust du jedes Teil mit array_map() über Schlüssel und Werte und verbindest dann. http_build_query() macht dasselbe für einen URL-Query-String und kodiert außerdem Leerzeichen und Sonderzeichen.

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

Dasselbe Muster verbindet nur die Schlüssel: implode(', ', array_keys($user)). Mehr zu Schlüsseln und Werten steht auf der Seite zu assoziativen Arrays.

Mit Zeilenumbruch verbinden oder eine HTML-Liste bauen

Das Trennzeichen kann ein beliebiger String sein. "\n" (doppelte Anführungszeichen) setzt jeden Wert in eine eigene Zeile, praktisch für Textdateien und Kommandozeilenausgabe. Mit HTML-Tags als Trennzeichen baut implode() eine Liste in einer Zeile. Führe den nächsten Block aus, und der Tab Page zeigt die gerenderte Liste.

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

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

Jeden Wert vor dem Verbinden mit htmlspecialchars() zu escapen, verhindert, dass ein Wert wie <b> zu Markup wird.

Mit „and“ vor dem letzten Eintrag verbinden

Eine gut lesbare Liste braucht meist ein „and“ vor dem letzten Element. Nimm es mit pop heraus, verbinde den Rest und häng es wieder an:

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

Typischer Fehler: verschachtelte Arrays

implode() arbeitet auf einer Ebene. Ein Element, das selbst ein Array ist, wird zum Wort Array, und PHP gibt eine Warnung aus:

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

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

Mach die inneren Arrays vorher flach oder verbinde jedes einzeln:

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