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 中还没有的键。