PHP implode(): unir los elementos de un array en un string

implode($separator, $array) une los valores de un array en una cadena, con $separator entre cada pareja: implode(', ', ['red', 'green', 'blue']) devuelve "red, green, blue".

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

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

El separador solo va entre los elementos, nunca antes del primero ni después del último. Es lo contrario de explode(), que divide una cadena en un array.

Sintaxis

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

Primero va el separador. El código antiguo a veces pasaba primero el array, implode($array, ', '). Ese orden quedó obsoleto en PHP 7.4 y se eliminó en PHP 8.0, donde lanza TypeError: implode(): Argument #2 ($array) must be of type ?array, string given.

implode vs join

join() es un alias de implode(). Aceptan los mismos argumentos y devuelven la misma cadena, así que elige uno y sé coherente.

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

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

Qué pasa con los números, los booleanos y null

Cada valor se convierte antes en cadena. Los números se imprimen como esperas, true se convierte en "1", y false y null se convierten en cadenas vacías, lo que deja dos 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 un array asociativo

implode() ignora las claves y une solo los valores. Para obtener pares key=value, construye cada trozo con array_map() sobre las claves y los valores, y luego únelos. http_build_query() hace lo mismo para una query string de URL y además codifica los espacios y los caracteres especiales.

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

El mismo patrón une solo las claves: implode(', ', array_keys($user)). Hay más sobre claves y valores en la página de arrays asociativos.

Unir con un salto de línea o generar una lista HTML

El separador puede ser cualquier cadena. "\n" (entre comillas dobles) pone cada valor en su propia línea, algo útil para archivos de texto y para la salida en la línea de comandos. Con etiquetas HTML como separador, implode() construye una lista en una línea. Ejecuta el siguiente bloque y la pestaña Página muestra la 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 con htmlspecialchars() antes de unir evita que un valor como <b> se convierta en marcado.

Unir con "y" antes del último elemento

Una lista legible para personas suele necesitar "y" antes del último elemento. Sácalo, une el resto y vuelve a añadirlo:

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

Error frecuente: arrays anidados

implode() trabaja con un solo nivel. Un elemento que es a su vez un array se convierte en la palabra Array, y PHP imprime un warning:

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

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

Aplana antes los arrays interiores, o une cada uno por separado:

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