在PHP开发中，arraylist通常指连续索引的数组，这类数组的索引从0开始依次递增，没有缺失的键名。判断并输出这类数组是日常开发中的常见需求，PHP8.1新增的array_is_list函数为这类操作提供了新的选择。
传统方式判断并输出arraylist
在PHP8.1之前，要判断一个数组是否为连续索引的arraylist，通常需要手动遍历数组验证键名是否符合规则，常见实现方式如下：
<?php
function isArrayList($arr) {
if (!is_array($arr)) {
return false;
}
$i = 0;
foreach ($arr as $key => $value) {
if ($key !== $i) {
return false;
}
$i++;
}
return true;
}
$testArr1 = [1, 2, 3, 4];
$testArr2 = [0 => 1, 2 => 3, 3 => 4];
var_dump(isArrayList($testArr1)); // 输出 bool(true)
var_dump(isArrayList($testArr2)); // 输出 bool(false)
?>
上述代码通过遍历数组的每个键名，和预期的递增索引对比，只要出现不匹配的情况就返回false，全部匹配则返回true。这种方式需要自定义函数，代码量较多，而且如果数组元素较多，遍历过程也会消耗一定的性能。
PHP8.1新增array_is_list函数的使用
PHP8.1版本原生提供了array_is_list函数，专门用于判断数组是否为连续索引数组，使用方式非常简单：
<?php $testArr1 = [1, 2, 3, 4]; $testArr2 = [0 => 1, 2 => 3, 3 => 4]; $testArr3 = ['a' => 1, 'b' => 2]; var_dump(array_is_list($testArr1)); // 输出 bool(true) var_dump(array_is_list($testArr2)); // 输出 bool(false) var_dump(array_is_list($testArr3)); // 输出 bool(false) ?>
该函数直接返回布尔值，不需要开发者手动实现判断逻辑，代码简洁度大幅提升。从性能角度来看，原生函数的执行效率也高于自定义遍历函数，尤其是在处理大数组时优势更明显。
两种方式的输出简洁度对比
我们可以通过一个实际场景对比两种方式的简洁度，假设需要输出数组内容，同时标注是否为arraylist：
传统方式实现
<?php
function isArrayList($arr) {
if (!is_array($arr)) {
return false;
}
$i = 0;
foreach ($arr as $key => $value) {
if ($key !== $i) {
return false;
}
$i++;
}
return true;
}
$arr = ['apple', 'banana', 'cherry'];
if (isArrayList($arr)) {
echo "当前是arraylist，内容为：";
print_r($arr);
} else {
echo "当前不是arraylist";
}
?>
使用array_is_list实现
<?php
$arr = ['apple', 'banana', 'cherry'];
if (array_is_list($arr)) {
echo "当前是arraylist，内容为：";
print_r($arr);
} else {
echo "当前不是arraylist";
}
?>
对比可以看出，使用新增函数后不需要自定义判断函数，整体代码行数减少，逻辑更清晰，输出相关的代码也更简洁。
arraylist输出的其他实用技巧
除了判断是否为arraylist，输出这类数组时还有一些实用技巧：
- 如果需要将arraylist转换为字符串输出，可以使用
implode函数，例如echo implode(',', $arr);可以直接输出逗号分隔的数组元素。 - 如果需要格式化输出arraylist，可以结合
json_encode函数，设置JSON_PRETTY_PRINT参数，得到可读性更高的输出结果。 - 当arraylist元素包含复杂类型时，使用
var_export函数可以输出可以直接执行的PHP代码格式，方便调试。
注意事项
使用array_is_list函数时需要注意，该函数仅支持PHP8.1及以上版本，如果项目运行在更低版本的PHP环境中，仍然需要使用传统的自定义判断方式。另外，空数组[]会被array_is_list判定为true，因为空数组符合连续索引的特征，实际使用时如果需要排除空数组的情况，需要额外添加判断逻辑。
总结来说，PHP8.1新增的array_is_list函数确实让arraylist的判断和输出操作变得更简洁，减少了自定义代码的工作量，同时提升了执行效率，建议在使用PHP8.1及以上版本的项目中优先使用该函数处理arraylist相关的判断需求。
PHParraylistarray_is_list输出数组8.1新增函数修改时间：2026-07-11 19:15:23