list() dan Destructuring Array PHP: [$a, $b] = $arr

[$a, $b] = $array; membongkar elemen-elemen array ke variabel terpisah dalam satu baris: $a mendapat $array[0], $b mendapat $array[1]. list($a, $b) = $array; adalah penulisan lama untuk hal yang sama, dan ['name' => $name] = $user; melakukannya berdasarkan key.

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

Memasangkan destructuring dengan explode() adalah penggunaan klasiknya: pecah string, beri nama potongannya, lanjut.

Melewati elemen

Kosongkan sebuah posisi untuk melewatinya. Kamu juga bisa berhenti lebih awal: elemen di akhir yang tidak dipakai akan diabaikan.

<?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 array asosiatif berdasarkan key

Dengan key, urutan di array tidak penting dan kamu hanya mengambil field yang kamu butuhkan. Key ditulis sebelum =>, variabelnya sesudahnya.

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

Pola juga bisa bersarang dengan cara yang sama untuk list: [[$x1, $y1], [$x2, $y2]] = $line; membaca dua titik sekaligus. Sejak PHP 7.3, variabel di dalam pola juga bisa berupa referensi, [, &$second] = $counts;, jadi mengubah $second akan mengubah array-nya.

Satu assignment memakai posisi atau key, tidak pernah keduanya. [$a, 'k' => $b] = $arr; berhenti dengan Cannot mix keyed and unkeyed array entries in assignments.

Menukar nilai dua variabel

Buat array berisi kedua nilai dengan urutan terbalik, lalu lakukan destructuring kembali. Tidak perlu variabel sementara.

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

Mengembalikan beberapa nilai dari fungsi

Fungsi PHP mengembalikan satu nilai, tetapi nilai itu boleh berupa array. Destructuring di tempat pemanggilan membuatnya terbaca seperti beberapa nilai kembalian. Untuk lebih dari dua atau tiga nilai, kembalikan dengan key supaya pemanggil tidak tertukar urutannya.

<?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 di foreach

Sintaks yang sama bekerja di baris foreach, jadi setiap baris data datang dalam keadaan sudah dipecah menjadi variabel bernama. Inilah yang dimaksud orang dengan "foreach dengan list()". Pola loop lainnya ada di halaman 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";
}

Spread operator (...)

Tiga titik membongkar array di tempat. Di literal array, [...$a, ...$b] menggabungkan array. Di pemanggilan fungsi, f(...$args) mengirim elemen-elemennya sebagai argumen terpisah. Di definisi fungsi, ...$args mengumpulkan argumen tambahan ke dalam sebuah array.

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

Sebelum PHP 8.1, melakukan spread pada array dengan key string menghasilkan error; sekarang key string dipertahankan dan key numerik dinomori ulang, aturan yang sama dengan array_merge(). Parameter variadic seperti ...$amounts dibahas bersama jenis parameter lainnya di halaman fungsi.

Kesalahan umum: elemen lebih sedikit daripada variabel

Kalau array-nya lebih pendek daripada polanya, variabel yang tidak kebagian menjadi null dan PHP mencetak warning untuk masing-masing. Ini terjadi pada input yang tidak kamu kendalikan, misalnya baris data yang field-nya tidak lengkap. Untuk [$name, $city, $country] = explode(',', 'Grace');, PHP mencetak:

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

Tentukan apa nilai untuk bagian yang hilang, lalu lengkapi array-nya sebelum destructuring:

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

Untuk pola dengan key, gabungkan dulu nilai bawaannya: ['a' => $a, 'b' => $b] = $input + ['a' => null, 'b' => null];. Operator + hanya menambahkan key yang belum dimiliki $input.