list() và destructuring mảng trong PHP: [$a, $b] = $arr

[$a, $b] = $array; tách các phần tử của một mảng ra thành từng biến riêng chỉ trong một dòng: $a nhận $array[0], $b nhận $array[1]. list($a, $b) = $array; là cách viết cũ hơn cho cùng việc đó, còn ['name' => $name] = $user; làm điều này theo khóa.

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

Kết hợp destructuring với explode() là cách dùng kinh điển: tách chuỗi, đặt tên cho từng phần, rồi làm tiếp.

Bỏ qua phần tử

Để trống một vị trí để bỏ qua nó. Bạn cũng có thể dừng sớm: các phần tử không dùng ở cuối sẽ bị bỏ qua.

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

Destructuring mảng kết hợp theo khóa

Khi dùng khóa, thứ tự trong mảng không còn quan trọng và bạn chỉ lấy những trường cần thiết. Khóa được viết trước =>, biến viết sau.

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

Với list, các mẫu cũng lồng nhau theo cách tương tự: [[$x1, $y1], [$x2, $y2]] = $line; đọc hai điểm cùng lúc. Từ PHP 7.3, một biến trong mẫu cũng có thể là tham chiếu, [, &$second] = $counts;, nên thay đổi $second sẽ thay đổi cả mảng.

Một phép gán chỉ dùng hoặc vị trí, hoặc khóa, không bao giờ cả hai. [$a, 'k' => $b] = $arr; dừng lại với lỗi Cannot mix keyed and unkeyed array entries in assignments.

Hoán đổi hai biến

Tạo một mảng chứa hai giá trị theo thứ tự ngược lại rồi destructure nó trở lại. Không cần biến tạm.

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

Trả về nhiều giá trị từ một hàm

Một hàm PHP chỉ trả về một giá trị, nhưng giá trị đó có thể là một mảng. Destructuring ở nơi gọi hàm khiến nó đọc như thể có nhiều giá trị trả về. Với hơn hai hoặc ba giá trị, hãy trả về mảng có khóa để nơi gọi không nhầm thứ tự.

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

Destructuring trong foreach

Cú pháp này cũng dùng được ngay trong dòng foreach, nên mỗi hàng đến tay bạn đã được tách sẵn thành các biến có tên. Đây chính là cái mà mọi người gọi là "foreach với list()". Các mẫu vòng lặp khác có ở trang 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";
}

Toán tử spread (...)

Ba dấu chấm giải nén một mảng ngay tại chỗ. Trong mảng literal, [...$a, ...$b] gộp các mảng lại. Trong lời gọi hàm, f(...$args) truyền các phần tử thành từng đối số riêng. Trong định nghĩa hàm, ...$args gom các đối số thừa vào một mảng.

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

Trước PHP 8.1, spread một mảng có khóa chuỗi là lỗi; giờ khóa chuỗi được giữ lại và khóa số được đánh số lại, theo cùng quy tắc với array_merge(). Tham số variadic như ...$amounts được trình bày cùng các loại tham số khác ở trang hàm.

Lỗi thường gặp: ít phần tử hơn số biến

Nếu mảng ngắn hơn mẫu, các biến bị thiếu sẽ thành null và PHP in một cảnh báo cho từng biến. Điều này xảy ra với dữ liệu đầu vào bạn không kiểm soát được, chẳng hạn một dòng bị thiếu trường. Với [$name, $city, $country] = explode(',', 'Grace');, PHP in ra:

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

Hãy quyết định phần bị thiếu nên là gì và bổ sung cho mảng trước khi destructure:

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

Với mẫu có khóa, hãy gộp giá trị mặc định vào trước: ['a' => $a, 'b' => $b] = $input + ['a' => null, 'b' => null];. Toán tử + chỉ thêm những khóa mà $input chưa có.