PHP implode(): unire gli elementi di un array in una stringa

implode($separator, $array) unisce i valori di un array in una sola stringa, con $separator tra ogni coppia: implode(', ', ['red', 'green', 'blue']) restituisce "red, green, blue".

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

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

Il separatore va solo tra gli elementi, mai prima del primo o dopo l'ultimo. È l'inverso di explode(), che divide una stringa in un array.

Sintassi

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

Il separatore viene prima. Il codice più vecchio a volte passava prima l'array, implode($array, ', '). Quell'ordine è stato deprecato in PHP 7.4 e rimosso in PHP 8.0, dove lancia TypeError: implode(): Argument #2 ($array) must be of type ?array, string given.

implode vs join

join() è un alias di implode(). Accettano gli stessi argomenti e restituiscono la stessa stringa, quindi scegline uno e sii coerente.

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

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

Cosa succede a numeri, booleani e null

Ogni valore viene prima convertito in stringa. I numeri vengono stampati come ti aspetti, true diventa "1", e false e null diventano stringhe vuote, il che lascia due separatori di fila.

<?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 di un array associativo

implode() ignora le chiavi e unisce solo i valori. Per ottenere coppie key=value, costruisci ogni pezzo con array_map() su chiavi e valori, poi uniscili. http_build_query() fa lo stesso per una query string di un URL e codifica anche spazi e caratteri speciali.

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

Lo stesso schema unisce solo le chiavi: implode(', ', array_keys($user)). Altro su chiavi e valori nella pagina sugli array associativi.

Unire con un a capo o costruire una lista HTML

Il separatore può essere qualsiasi stringa. "\n" (virgolette doppie) mette ogni valore su una riga a sé, comodo per file di testo e output da riga di comando. Con dei tag HTML come separatore, implode() costruisce una lista in una riga. Esegui il blocco seguente e la scheda Page mostra la lista.

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

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

Applicare htmlspecialchars() a ogni valore prima di unirli impedisce che un valore come <b> diventi markup.

Unire con "e" prima dell'ultimo elemento

Una lista leggibile di solito richiede "e" prima dell'ultimo elemento. Toglilo con pop, unisci il resto, poi riaggiungilo:

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

Errore comune: array annidati

implode() lavora su un solo livello. Un elemento che è a sua volta un array viene convertito nella parola Array, e PHP stampa un warning:

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

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

Appiattisci prima gli array interni, oppure unisci ciascuno separatamente:

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