implode() w PHP: łączenie elementów tablicy w string

implode($separator, $array) łączy wartości tablicy w jeden string, wstawiając $separator między każdą parę: implode(', ', ['red', 'green', 'blue']) zwraca "red, green, blue".

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

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

Separator trafia tylko między elementy, nigdy przed pierwszy ani po ostatnim. To odwrotność explode(), które dzieli string na tablicę.

Składnia

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

Separator jest pierwszy. Starszy kod czasem przekazywał najpierw tablicę, implode($array, ', '). Ta kolejność została oznaczona jako przestarzała w PHP 7.4 i usunięta w PHP 8.0, gdzie rzuca TypeError: implode(): Argument #2 ($array) must be of type ?array, string given.

implode vs join

join() to alias implode(). Przyjmują te same argumenty i zwracają ten sam string, więc wybierz jedną nazwę i trzymaj się jej.

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

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

Co dzieje się z liczbami, wartościami logicznymi i null

Każda wartość jest najpierw zamieniana na string. Liczby wypisują się tak, jak się spodziewasz, true staje się "1", a false i null stają się pustymi stringami, co zostawia dwa separatory pod rząd.

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

implode() ignoruje klucze i łączy tylko wartości. Aby dostać pary key=value, zbuduj każdy kawałek przez array_map() na kluczach i wartościach, a potem połącz. http_build_query() robi to samo dla query stringa w adresie URL i dodatkowo koduje spacje oraz znaki specjalne.

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

Ten sam wzorzec łączy same klucze: implode(', ', array_keys($user)). Więcej o kluczach i wartościach znajdziesz na stronie o tablicach asocjacyjnych.

Łączenie znakiem nowej linii lub budowanie listy HTML

Separatorem może być dowolny string. "\n" (podwójne cudzysłowy) umieszcza każdą wartość w osobnej linii, co przydaje się w plikach tekstowych i w wierszu poleceń. Ze znacznikami HTML jako separatorem implode() buduje listę w jednej linii. Uruchom następny blok, a zakładka Page pokaże wyrenderowaną listę.

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

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

Escapowanie każdej wartości przez htmlspecialchars() przed połączeniem sprawia, że wartość taka jak <b> nie staje się znacznikiem.

Łączenie z „and” przed ostatnim elementem

Czytelna dla człowieka lista zwykle potrzebuje spójnika przed ostatnim elementem. Zdejmij go, połącz resztę, a potem dodaj z powrotem:

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

Częsty błąd: zagnieżdżone tablice

implode() działa na jednym poziomie. Element, który sam jest tablicą, zamienia się w słowo Array, a PHP wypisuje ostrzeżenie:

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

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

Najpierw spłaszcz wewnętrzne tablice albo połącz każdą osobno:

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