PHP implode() : assembler un tableau en chaîne

implode($separator, $array) assemble les valeurs d'un tableau en une seule chaîne, avec $separator entre chaque paire : implode(', ', ['red', 'green', 'blue']) renvoie "red, green, blue".

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

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

Le séparateur se place uniquement entre les éléments, jamais avant le premier ni après le dernier. C'est l'inverse d'explode(), qui découpe une chaîne en tableau.

Syntaxe

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

Le séparateur vient en premier. Du code ancien passait parfois le tableau en premier, implode($array, ', '). Cet ordre a été déprécié en PHP 7.4 et supprimé en PHP 8.0, où il lève TypeError: implode(): Argument #2 ($array) must be of type ?array, string given.

implode ou join

join() est un alias d'implode(). Elles prennent les mêmes arguments et renvoient la même chaîne, choisissez-en donc une et tenez-vous-y.

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

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

Ce que deviennent les nombres, les booléens et null

Chaque valeur est d'abord convertie en chaîne. Les nombres s'affichent comme prévu, true devient "1", et false et null deviennent des chaînes vides, ce qui laisse deux séparateurs à la suite.

<?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 sur un tableau associatif

implode() ignore les clés et n'assemble que les valeurs. Pour obtenir des paires key=value, construisez chaque morceau avec array_map() sur les clés et les valeurs, puis assemblez. http_build_query() fait la même chose pour une query string d'URL et encode aussi les espaces et caractères spéciaux.

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

Le même modèle assemble seulement les clés : implode(', ', array_keys($user)). Les clés et valeurs sont détaillées sur la page des tableaux associatifs.

Assembler avec un saut de ligne ou construire une liste HTML

Le séparateur peut être n'importe quelle chaîne. "\n" (entre guillemets doubles) met chaque valeur sur sa propre ligne, pratique pour des fichiers texte et la sortie en ligne de commande. Avec des balises HTML comme séparateur, implode() construit une liste en une ligne. Exécutez le bloc suivant et l'onglet Page affiche la liste rendue.

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

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

Échapper chaque valeur avec htmlspecialchars() avant l'assemblage empêche une valeur comme <b> de devenir du balisage.

Assembler avec « et » avant le dernier élément

Une liste lisible demande en général « et » avant le dernier élément. Retirez-le, assemblez le reste, puis rajoutez-le :

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

Erreur fréquente : les tableaux imbriqués

implode() travaille sur un seul niveau. Un élément qui est lui-même un tableau est converti en mot Array, et PHP affiche un warning :

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

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

Aplatissez d'abord les tableaux intérieurs, ou assemblez chacun séparément :

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