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> 같은 값이 마크업이 되지 않습니다.

마지막 항목 앞에 "and" 넣어 합치기

사람이 읽는 목록에는 보통 마지막 요소 앞에 "and"가 필요합니다. 마지막 요소를 꺼내고, 나머지를 합친 다음, 다시 붙이세요.

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