PHP implode(): объединить элементы массива в строку

implode($separator, $array) склеивает значения массива в одну строку, ставя $separator между каждой парой: implode(', ', ['red', 'green', 'blue']) возвращает "red, green, blue".

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

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

Разделитель ставится только между элементами, никогда перед первым или после последнего. Это обратная операция для explode(), которая разбивает строку на массив.

Синтаксис

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

Разделитель идёт первым. Старый код иногда передавал массив первым, implode($array, ', '). Такой порядок объявили устаревшим в PHP 7.4 и удалили в PHP 8.0, где он выбрасывает TypeError: implode(): Argument #2 ($array) must be of type ?array, string given.

implode и join

join() это псевдоним implode(). Они принимают одинаковые аргументы и возвращают одинаковую строку, так что выберите одну и придерживайтесь её.

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

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

Что происходит с числами, логическими значениями и null

Каждое значение сначала приводится к строке. Числа выводятся так, как вы ожидаете, true становится "1", а false и null становятся пустыми строками, из-за чего два разделителя оказываются подряд.

<?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 для ассоциативного массива

implode() игнорирует ключи и склеивает только значения. Чтобы получить пары key=value, соберите каждую часть через array_map() по ключам и значениям, а потом склейте. http_build_query() делает то же для строки запроса URL и ещё кодирует пробелы и спецсимволы.

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

По той же схеме склеиваются только ключи: implode(', ', array_keys($user)). Подробнее о ключах и значениях на странице про ассоциативные массивы.

Склейка через перенос строки или HTML-список

Разделителем может быть любая строка. "\n" (в двойных кавычках) ставит каждое значение на отдельную строку, что удобно для текстовых файлов и вывода в командной строке. С HTML-тегами в качестве разделителя implode() собирает список одной строкой. Запустите следующий блок, и вкладка Page покажет готовый список.

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

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

Экранирование каждого значения через htmlspecialchars() перед склейкой не даёт значению вроде <b> превратиться в разметку.

Склейка с "и" перед последним элементом

Человекочитаемому списку обычно нужно "и" перед последним элементом. Снимите его с конца, склейте остальное и добавьте обратно:

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

Частая ошибка: вложенные массивы

implode() работает с одним уровнем. Элемент, который сам является массивом, превращается в слово Array, а PHP печатает предупреждение:

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

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

Сначала сделайте вложенные массивы плоскими или склейте каждый по отдельности:

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