PHP list怎么用-php教程-PHP中文网

list()是语言结构，只处理数字索引数组（php 7.1+支持键名解构），若用于关联数组或非0起始索引数组，会因索引缺失触发undefined offset错误或变量为空。

php list怎么用

PHP 的 list() 不是函数，是语言结构，只处理数字索引数组（PHP 7.1+ 可带键），用错类型或顺序不匹配就会静默出错或报 Notice。

常见现象：对关联数组或非 0 起始的索引数组使用 list()，输出全是空、报 Notice: Undefined offset，甚至变量没被赋值。

list() 完全忽略键名，只按「值的顺序位置」赋值，等价于先调用 array_values() 再取前 N 个
数组必须至少有对应数量的元素，少一个就触发 Notice（PHP 8+ 直接 ValueError）
下标不从 0 开始？比如 [1 => 'a', 2 => 'b']，list($x, $y) 会把 'a' 赋给 $y，$x 是 null —— 因为它找的是索引 0 和 1 的值，而索引 0 不存在
别用 @list() 压制错误，掩盖了数组结构不匹配的真实问题

PHP 7.1 起支持在 list() 和 [] 中显式写键，但仅限于「已知结构的关联数组」，不是万能方案。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

正确写法（需键名完全匹配）：list("id" => $id, "name" => $name) = $row;
更推荐用短数组解构：["id" => $id, "name" => $name] = $row;，语法更紧凑，语义更清晰
如果键名不确定或动态，别硬套 list() 或 []，改用 $id = $row['id'] ?? null; 或 extract($row)（注意变量污染风险）
混合用法危险：list($a, "name" => $name) = $arr; 要求 $arr 同时是「有数字索引 + 有指定键」的数组，极易出错，不建议

这是 list() 最实用的场景之一，但容易忽略数组结构一致性。

多维索引数组（如数据库查询结果）可直接写：foreach ($rows as list($id, $title, $status)) { ... }
多维关联数组（如 [["id"=>1,"name"=>"A"], ["id"=>2,"name"=>"B"]]）要加键：foreach ($rows as list("id" => $id, "name" => $name)) { ... }
只要某一行数据缺失字段（比如某条记录没有 "name" 键），整个 foreach 就会中断并报 Notice —— 所以生产环境务必确保数据结构统一
不想冒险？退回到传统写法：foreach ($rows as $row) { $id = $row['id'] ?? 0; $name = $row['name'] ?? ''; }，可控性更高

PHP 7.1+ 两者功能重叠，但行为和适用边界不同。

list($a, $b) = $arr; 和 [$a, $b] = $arr; 效果一致，后者更现代、支持跳过元素（[$a, , $c] = $arr;）和默认值（[$a, $b = 'default'] = $arr;）
list() 在 PHP 7.1+ 支持键语法，但 [] 的键解构更自然、更常用，例如：["code" => $code, "msg" => $msg] = api_call();
函数返回值接收场景，优先用 []：[$width, $height] = get_dimensions(); 比 list($width, $height) = get_dimensions(); 更直观
唯一 list() 还有用武之地的是老代码兼容，或某些 IDE/静态分析工具对 [] 解构支持不全的边缘情况