PHP list()와 배열 구조 분해: [$a, $b] = $arr

[$a, $b] = $array;는 배열의 요소를 한 줄에 개별 변수로 분해합니다. $a는 $array[0]을, $b는 $array[1]을 받습니다. list($a, $b) = $array;는 같은 것의 옛 표기이고, ['name' => $name] = $user;는 키로 같은 일을 합니다.

<?php
$point = [3, 7];
[$x, $y] = $point;
echo "x = $x, y = $y\n";

// Same thing with list()
list($x, $y) = $point;
echo "x = $x, y = $y\n";

// Very common with explode()
[$user, $domain] = explode('@', 'ada@example.com');
echo "User: $user, domain: $domain\n";

구조 분해를 explode()와 함께 쓰는 것이 대표적인 용도입니다. 문자열을 나누고, 조각에 이름을 붙이고, 다음으로 넘어갑니다.

요소 건너뛰기

위치를 비워 두면 건너뜁니다. 일찍 멈출 수도 있습니다. 끝에 남는 요소는 무시됩니다.

<?php
$row = ['2026-03-14', 'Ada', 'Lovelace', 'admin', 'active'];

[, $first, $last] = $row;            // skip the date, ignore the rest
echo "$first $last\n";

[$date, , , $role] = $row;           // skip two in the middle
echo "$date: $role\n";

// Only the time part of a timestamp string
[, $time] = explode(' ', '2026-03-14 09:30:00');
echo "Time: $time\n";

연관 배열을 키로 구조 분해하기

키를 쓰면 배열 안의 순서는 상관없고 필요한 필드만 가져옵니다. 키는 => 앞에, 변수는 뒤에 씁니다.

<?php
$user = ['id' => 7, 'name' => 'Grace', 'email' => 'grace@example.com', 'age' => 45];

['name' => $name, 'email' => $email] = $user;
echo "$name <$email>\n";

// Rename while you extract
['id' => $userId] = $user;
echo "User #$userId\n";

// Keys can be expressions
$field = 'age';
[$field => $value] = $user;
echo "$field: $value\n";

// Nested: reach inside a nested array
$order = ['id' => 5, 'customer' => ['name' => 'Ada', 'country' => 'UK']];
['id' => $id, 'customer' => ['country' => $country]] = $order;
echo "Order $id ships to $country\n";

리스트에서도 패턴을 같은 방식으로 중첩할 수 있습니다. [[$x1, $y1], [$x2, $y2]] = $line;은 두 점을 한 번에 읽습니다. PHP 7.3부터 패턴 안의 변수가 참조일 수도 있어서([, &$second] = $counts;) $second를 바꾸면 배열이 바뀝니다.

한 대입에서는 위치나 키 중 하나만 쓰며, 둘을 함께 쓸 수 없습니다. [$a, 'k' => $b] = $arr;는 Cannot mix keyed and unkeyed array entries in assignments와 함께 멈춥니다.

두 변수 맞바꾸기

두 값을 반대 순서로 담은 배열을 만들고 다시 구조 분해하세요. 임시 변수가 필요 없습니다.

<?php
$a = 'left';
$b = 'right';

[$a, $b] = [$b, $a];
echo "$a $b\n";

// Rotate three values
$x = 1; $y = 2; $z = 3;
[$x, $y, $z] = [$y, $z, $x];
echo "$x $y $z\n";

함수에서 여러 값 반환하기

PHP 함수는 값을 하나 반환하지만, 그 값이 배열일 수 있습니다. 호출하는 쪽에서 구조 분해하면 여러 값을 반환하는 것처럼 읽힙니다. 값이 두세 개보다 많다면 호출하는 쪽이 순서를 헷갈리지 않도록 키와 함께 반환하세요.

<?php
function minMax(array $numbers): array
{
    return [min($numbers), max($numbers)];
}

[$low, $high] = minMax([4, 9, 1, 7]);
echo "Range: $low to $high\n";

function parseName(string $full): array
{
    $parts = explode(' ', $full, 2);
    return ['first' => $parts[0], 'last' => $parts[1] ?? ''];
}

['last' => $last, 'first' => $first] = parseName('Ada Lovelace');
echo "$last, $first\n";

foreach 안의 구조 분해

같은 문법이 foreach 줄에서도 동작하므로 각 행이 이미 이름 붙은 변수로 나뉘어 들어옵니다. 사람들이 "list()를 쓰는 foreach"라고 말하는 것이 이것입니다. 더 많은 반복문 패턴은 foreach 페이지에 있습니다.

<?php
$routes = [
    ['GET', '/users', 'listUsers'],
    ['POST', '/users', 'createUser'],
    ['GET', '/users/{id}', 'showUser'],
];

foreach ($routes as [$method, $path, $handler]) {
    printf("%-5s %-12s -> %s()\n", $method, $path, $handler);
}

$people = [
    ['name' => 'Ada', 'city' => 'London'],
    ['name' => 'Linus', 'city' => 'Helsinki'],
];

foreach ($people as ['name' => $name, 'city' => $city]) {
    echo "$name lives in $city\n";
}

스프레드 연산자(...)

점 세 개는 배열을 그 자리에서 풀어 놓습니다. 배열 리터럴에서 [...$a, ...$b]는 배열을 합칩니다. 함수 호출에서 f(...$args)는 요소를 별도의 인수로 넘깁니다. 함수 정의에서 ...$args는 남는 인수를 배열로 모읍니다.

<?php
$fruits = ['apple', 'pear'];
$veg = ['carrot'];
$all = [...$fruits, ...$veg, 'bread'];
print_r($all);

// String keys too (PHP 8.1): later keys win, like array_merge
$defaults = ['color' => 'blue', 'size' => 'M'];
$custom = ['size' => 'L'];
print_r([...$defaults, ...$custom]);

// Unpack into function arguments
$numbers = [4, 9, 1];
echo max(...$numbers), "\n";

// Collect any number of arguments
function total(float ...$amounts): float
{
    return array_sum($amounts);
}
echo total(1.5, 2.5, 6), "\n";

PHP 8.1 이전에는 문자열 키가 있는 배열을 펼치면 에러였습니다. 이제는 array_merge()와 같은 규칙으로 문자열 키는 유지되고 숫자 키는 다시 매겨집니다. ...$amounts 같은 가변 매개변수는 다른 매개변수 종류와 함께 함수 페이지에서 다룹니다.

흔한 실수: 변수보다 적은 요소

배열이 패턴보다 짧으면 빠진 변수는 null이 되고 PHP는 각각에 대해 경고를 출력합니다. 필드가 빠진 줄처럼 직접 통제할 수 없는 입력에서 생깁니다. [$name, $city, $country] = explode(',', 'Grace');에 대해 PHP는 다음을 출력합니다.

Warning: Undefined array key 1 in /var/www/html/import.php on line 5

Warning: Undefined array key 2 in /var/www/html/import.php on line 5

빠진 조각이 무엇이어야 할지 정하고, 구조 분해 전에 배열을 채우세요.

<?php
$lines = ['Ada,London,UK', 'Linus,Helsinki', 'Grace'];

foreach ($lines as $line) {
    [$name, $city, $country] = array_pad(explode(',', $line), 3, 'unknown');
    echo "$name | $city | $country\n";
}

키 패턴이라면 먼저 기본값을 합치세요: ['a' => $a, 'b' => $b] = $input + ['a' => null, 'b' => null];. + 연산자는 $input에 아직 없는 키만 추가합니다.