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, поэтому каждая строка приходит уже разобранной на именованные переменные. Именно это имеют в виду под "foreach с list()". Другие шаблоны циклов на странице про 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 ещё нет.