萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP list() 函數深度解析:陣列解構賦值、資料庫 fetch 搭配、右至左賦值陷阱

基本語法與用途

array list(mixed $var1, mixed $var2, ...)
  • 將**數字索引陣列** (0 起始) 的值解構賦值給變數。
  • 類似解構賦值:[$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";
?>

資料庫 fetch 經典搭配

<?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 7.1+ 短語法 [] (推薦)

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

list() 進階:搭配 each() 遍歷 (舊式)

<?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()。
copyright © 萬盛學電腦網 all rights reserved