array list(mixed $var1, mixed $var2, ...)
[$a, $b] = $arr (PHP 7.1+ 短語法)。array_values() 重索引。<?php
$info = ['coffee', 'brown', 'caffeine'];
// 全部接收
list($drink, $color, $power) = $info;
echo "$drink is $color and $power makes it special.\n";
// 略過中間
list($drink, , $power) = $info;
echo "$drink has $power.\n";
// 只取第三個
list(, , $power) = $info;
echo "I need $power!\n";
?>
<?php
// mysqli 範例
$mysqli = new mysqli('localhost', 'user', 'pass', 'db');
$result = $mysqli->query('SELECT id, name, salary FROM employees');
echo '<table><tr><th>Name</th><th>Salary</th></tr>';
while (list($id, $name, $salary) = $result->fetch_row()) {
echo "<tr><td><a href='info.php?id=$id'>$name</a></td>";
echo "<td>$salary</td></tr>";
}
echo '</table>';
$result->free();
$mysqli->close();
?>
list() 從最右邊參數開始賦值,對一般變數無影響,但搭配**索引陣列**當目標時會產生反直覺結果:
<?php
$info = ['coffee', 'brown', 'caffeine'];
list($a[0], $a[1], $a[2]) = $info;
var_dump($a);
/*
輸出:
array(3) {
[2] => string(8) "caffeine" // 最右邊先賦值
[1] => string(5) "brown"
[0] => string(6) "coffee" // 最左邊最後賦值
}
*/
?>
原因:PHP 先計算右側陣列值,再從右至左依序執行 $a[2] = 'caffeine'、$a[1] = 'brown'、$a[0] = 'coffee'。若 $a 陣列原本有值,中間過程可能被覆蓋。
<?php
$info = ['coffee', 'brown', 'caffeine'];
// 對稱解構,左至右語意清晰
[$drink, $color, $power] = $info;
// 略過元素
[$drink, , $power] = $info;
// 多維解構
$users = [
['John', 25, 'NY'],
['Jane', 30, 'LA']
];
foreach ($users as [$name, $age, $city]) {
echo "$name, $age, $city<br>";
}
// 鍵值解構 (關聯陣列)
$user = ['id' => 1, 'name' => 'John', 'email' => 'john@example.com'];
['id' => $id, 'name' => $name, 'email' => $email] = $user;
?>
<?php
$user = ['id' => 1, 'name' => 'zhangsan', 'age' => 10, 'sex' => 'nan'];
while (list($key, $value) = each($user)) {
echo "$key ---> $value<br>";
}
// 注意:each() 已在 PHP 8.0 棄用,新代碼請用 foreach
?>
| 場景 | 範例 |
|---|---|
| 多返回值函數 | list($success, $data, $msg) = $service->doAction(); |
| CSV/固定欄位解析 | list($id, $name, $email) = str_getcsv($line); |
| 日期時間拆解 | list($y, $m, $d) = explode('-', $date); |
| 路由參數提取 | ['controller' => $c, 'action' => $a] = $route; |
list($a[0], $a[1]) 的反序賦值行為。fetch_row()、explode()、str_getcsv() 使用極為方便。list() 只吃數字索引 0 起始陣列,關聯陣列需先 array_values()。