array_is_list 判断数组是否为「列表数组」：键必须是从 0 开始的连续整数，且元素个数等于最大键 + 1；它不关心值类型，只校验键结构，空数组返回 true，PHP 8.4 起可用。
array_is_list 是什么，它到底在判断什么
它只判断一个数组是否为「列表数组」：键必须是从 0 开始的连续整数，且元素个数等于最大键 + 1。不是看值类型，也不关心是否「看起来像列表」——比如 ['a' => 1, 'b' => 2] 或 [1 => 'x', 2 => 'y'] 都返回 false。
怎么用 array_is_list 判断常见数组结构
直接传入数组即可，返回布尔值。注意它不修改原数组，也不抛异常：
var_dump(array_is_list([1, 2, 3])); // true var_dump(array_is_list([0 => 1, 1 => 2])); // true var_dump(array_is_list([1 => 'a', 2 => 'b'])); // false（起始键不是 0） var_dump(array_is_list([0 => 'x', 2 => 'y'])); // false（键不连续） var_dump(array_is_list(['a', 'b', 'c'])); // true var_dump(array_is_list([])); // true（空数组也是 list）
- 它对关联数组、稀疏索引数组、字符串键数组一律返回
false - 即使数组值全是数字或全是字符串，只要键不符合规则，就不是 list
- PHP 8.4 之前没有这个函数，别在低版本中尝试调用，会报
Fatal error: Uncaught Error: Call to undefined function array_is_list()
和 is_array()、array_values() 混用时的坑
is_array() 只确认是不是数组，不区分结构；而 array_is_list() 是更严格的结构断言。有人想「先重索引再判断」，比如：
$arr = [1 => 'a', 2 => 'b']; var_dump(array_is_list(array_values($arr))); // true —— 但这改变了原始语义
这种写法容易掩盖真实数据结构问题：
PHP 8.5.12 RC 1
下载
PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
-
array_values()强制重排键，代价是额外内存与 CPU，对大数组不友好 - 如果业务逻辑依赖原始键（比如 ID 映射），用
array_values()后再判 list 就失去意义 - 真正该用
array_is_list()的场景，是明确需要「可安全用于 foreach 顺序遍历 + 支持 [] 下标访问」的数组，比如传给array_chunk()、array_slice()或 JSON 编码为数组而非对象
实际项目中建议的使用姿势
它最适合做输入校验或类型断言，尤其在函数参数约束、API 请求体解析、配置项预检环节：
function processList(array $data): void {
if (!array_is_list($data)) {
throw new InvalidArgumentException('Expected a list-style array');
}
// 后续可放心用 for ($i = 0; $i < count($data); $i++) 或 $data[0] 等操作
}
- 不要把它当「类型转换工具」，它不改变数据
- 和
json_encode()行为强相关：只有array_is_list()返回true的数组，json_encode()才输出[...]而非{...} - 如果数组来自
mysqli_fetch_all(MYSQLI_ASSOC)或pdo::FETCH_ASSOC，默认不是 list，别误以为能直接用
它的边界很清晰：只认键，不看值，不修复结构，也不兼容旧版 PHP。用错地方比不用还容易埋雷。
