PHPのlist()と分割代入：[$a, $b] = $arr

[$a, $b] = $array;は、配列の要素を1行で別々の変数に分けます。$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;は2つの点を一度に読みます。PHP 7.3以降は、パターンの中の変数を参照にすることもでき（[, &$second] = $counts;）、$secondを変えると配列も変わります。

1つの代入では位置かキーのどちらかを使い、両方は使えません。[$a, 'k' => $b] = $arr;はCannot mix keyed and unkeyed array entries in assignmentsで止まります。

2つの変数を入れ替える

2つの値を逆の順番にした配列を作り、分割代入で戻します。一時的な変数は要りません。

<?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の関数が返す値は1つですが、その値を配列にできます。呼び出し側で分割代入すれば、複数の戻り値のように読めます。値が2つか3つより多いときは、呼び出し側が順番を取り違えないようキーを付けて返しましょう。

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

スプレッド演算子（...）

ドット3つは、配列をその場で展開します。配列リテラルの中では、[...$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がまだ持っていないキーだけを追加します。