array_is_list() 自 php 8.1 引入,要求键为连续整数且从 0 开始,php 8.5.7 未改变其逻辑,仅可能修复极少数边界 bug;它不等价于“无字符串键”,对浮点、字符串、null 键均返回 false。

array_is_list 在 PHP 8.1+ 才可用,8.5.7 并不“更精准”
PHP 8.1 引入了 array_is_list(),它判断一个数组是否为“列表”(即键是连续的、从 0 开始的整数索引)。PHP 8.5.7 只是某个补丁版本,它没有修改 array_is_list() 的行为——该函数自 8.1 起逻辑就已固定。所谓“更精准”,其实是误读:8.5.7 可能修复了某些极端边界 case 的 bug(比如含 null 键或浮点键的非法输入),但日常使用中几乎感知不到差异。
常见错误现象:array_is_list(['a' => 1, 'b' => 2]) 返回 false(正确);array_is_list([1 => 'x', 0 => 'y']) 也返回 false(因为键顺序不是 0,1,2…,哪怕值存在);但有人误以为只要“没字符串键”就算 list,这是错的。
判断索引数组不能只靠 array_is_list()
很多人想“检测是不是纯数字索引数组”,但 array_is_list() 要求更严格:它要求键必须是 0,1,2,...,n-1 连续整数。而像 [1 => 'a', 2 => 'b'] 或 [0 => 'a', 2 => 'c'] 都会被判为 false,尽管它们只有数字键。
- 如果业务只要求“无字符串键”,用
array_keys($arr) === array_keys(array_filter(array_keys($arr), 'is_int'))太重,更简单的是:!count(array_filter(array_keys($arr), 'is_string')) - 如果要求“键从 0 开始且连续”,
array_is_list()正确且高效,无需手写循环 - 如果只是想安全地用
foreach或for遍历,其实多数场景根本不需要判断——PHP 数组本身支持混合键,直接遍历即可
兼容 PHP
在旧版本里硬套 array_is_list() 会报 Fatal error: Uncaught Error: Call to undefined function array_is_list()。别用 function_exists() 包裹后调用——它不存在就是不存在,包裹也没用。
可靠替代(等价于 8.1+ 的 array_is_list()):
function array_is_list($arr): bool {
if (!is_array($arr)) return false;
if ($arr === []) return true;
$keys = array_keys($arr);
return $keys === array_keys($keys);
}
说明:array_keys($arr) 提取所有键,array_keys($keys) 相当于 [0,1,2,...],两者相等即说明原数组键是连续整数且从 0 开始。注意:这个实现对稀疏数组(如 [0=>'a', 2=>'c'])返回 false,和原生函数一致。
容易被忽略的 key 类型陷阱
array_is_list() 对键类型极其敏感。以下都会返回 false:
-
[0.0 => 'x']—— 浮点数键不被接受,即使值是0.0 -
[0 => 'a', '0' => 'b']—— 混合整数和字符串键(PHP 会把'0'当作字符串键,不与0合并) -
[0 => 'a', null => 'b']——null作为键会被转成空字符串'',属于字符串键
所以,如果你从 JSON 解码得到数组(json_decode($json, true)),它总是返回关联数组,哪怕 JSON 是 [1,2,3] —— 因为 PHP 的 JSON 解码器在 true 模式下不会主动优化成 list 结构。别指望它自动满足 array_is_list() 条件。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











