PHP implode(): juntar elementos de um array numa string

implode($separator, $array) junta os valores de um array numa string, com $separator entre cada par: implode(', ', ['red', 'green', 'blue']) retorna "red, green, blue".

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

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

O separador só vai entre os elementos, nunca antes do primeiro nem depois do último. É o inverso do explode(), que divide uma string em array.

Sintaxe

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

O separador vem primeiro. Código antigo às vezes passava o array primeiro, implode($array, ', '). Essa ordem foi depreciada no PHP 7.4 e removida no PHP 8.0, onde lança TypeError: implode(): Argument #2 ($array) must be of type ?array, string given.

implode ou join

join() é um alias de implode(). Eles recebem os mesmos argumentos e retornam a mesma string, então escolha um e seja consistente.

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

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

O que acontece com números, booleanos e null

Cada valor é convertido em string primeiro. Números aparecem como você espera, true vira "1", e false e null viram strings vazias, o que deixa dois separadores seguidos.

<?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 de um array associativo

O implode() ignora as chaves e junta só os valores. Para ter pares key=value, monte cada parte com array_map() sobre as chaves e os valores e depois junte. O http_build_query() faz o mesmo para uma query string de URL e também codifica espaços e caracteres especiais.

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

O mesmo padrão junta só as chaves: implode(', ', array_keys($user)). Mais sobre chaves e valores na página sobre arrays associativos.

Juntar com quebra de linha ou montar uma lista HTML

O separador pode ser qualquer string. "\n" (aspas duplas) coloca cada valor numa linha própria, o que é prático para arquivos de texto e saída na linha de comando. Com tags HTML como separador, o implode() monta uma lista numa linha. Rode o próximo bloco e a aba Page mostra a lista renderizada.

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

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

Escapar cada valor com htmlspecialchars() antes de juntar impede que um valor como <b> vire marcação.

Juntar com "e" antes do último item

Uma lista legível para pessoas normalmente precisa de "e" antes do último elemento. Tire o último com pop, junte o resto e depois adicione-o de volta:

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

Erro comum: arrays aninhados

O implode() trabalha com um nível. Um elemento que é ele mesmo um array é convertido na palavra Array, e o PHP imprime um aviso:

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

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

Achate os arrays internos antes, ou junte cada um separadamente:

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