PHP array_is_list 与 array_keys 判断连续数组：列表结构和关联数组的选型

接口收到一组筛选条件时，PHP 数组看起来都像“键值对”，但 `['php', 'mysql']` 和 `['primary' => 'php']` 的含义并不一样。前者可以按顺序遍历，后者表达的是字段名；如果把它们混着传给 JSON 参数或批量查询，问题通常会在更晚的地方才暴露。

先把列表数组和关联数组分开

PHP 的 array 是有序键值对容器。连续整数键从 0 开始、按顺序递增时，`array_is_list()` 才会返回 `true`。值可以是字符串、对象甚至另一个数组，函数并不关心值长什么样。

 'published', 'page' => 1];

var_dump(array_is_list($tags));    // true
var_dump(array_is_list($filters)); // false

$tags[2] = 'redis';
var_dump(array_is_list($tags));    // true

unset($tags[1]);
var_dump(array_is_list($tags));    // false，键变成 0、2

这里最容易误判的是最后一行：`unset()` 删除了元素，却没有自动把后面的键往前搬。数据内容没少很多，但结构已经从列表变成了带缺口的整数键数组。

三个函数各自解决什么问题

选函数时先问一句：你要判断结构、读取键，还是生成一份重新编号的数据？这三个动作看似相近，返回值和副作用完全不同。

因此，下面这种写法表达的是“我要检查结构”，比拿 `array_keys()` 和 `range()` 拼一个比较式更清楚：

如果业务要求接收关联形式，例如 `['primary' => 'php']`，就不要为了通过检查而调用 `array_values()`；那会抹掉字段名。

按场景选择函数，而不是按习惯复制数组

接口参数需要“数组列表”

批量标签、ID 集合、排序后的选项通常需要列表语义。先用 `array_is_list()` 验证，再检查元素类型：

这里的两个判断各管一件事：第一个挡住缺口键和字符串键，第二个挡住混入字符串 ID 的情况。不要期待 `array_is_list()` 替你做值校验。

需要查看字段名或筛选某个值

日志排查和映射转换更适合 `array_keys()`。例如只找值为 `published` 的字段，并使用严格比较避免数字字符串与整数发生宽松匹配：

 'published', 'cache' => 'draft', 'page' => 1];
$publishedFields = array_keys($states, 'published', true);
// ['article']

`array_keys()` 返回的是新数组，数据量很大时不要在循环里反复调用。只想判断结构时，它反而做了多余工作。

排序或删除后确实要重新编号

当你明确要把结果作为 JSON 列表输出，可以在筛选结束后调用 `array_values()`：

 $tag !== 'internal');
$payload = array_values($visible);
echo json_encode($payload, JSON_UNESCAPED_UNICODE);

如果输出的是对象映射，保留键更重要，就不要重排。函数选择要跟外部协议的形状一致。

PHP 8.0 及更早版本的兼容判断

`array_is_list()` 的最低版本是 PHP 8.1。项目还运行在 PHP 8.0 时，可以用一次遍历实现同样的结构判断：

 $_value) {
        if ($key !== $expected) {
            return false;
        }
        $expected++;
    }
    return true;
}

空数组会返回 `true`，这与 PHP 8.1 的内置函数保持一致。若项目已有 polyfill，建议用测试锁住空数组、起始键为 1、键顺序反转和混合键这几类边界，不要只测普通列表。

常见问题

空数组算列表吗？

算。`array_is_list([])` 返回 `true`，调用方如果要求至少一个元素，还要单独判断 `count($array) > 0`。

array_is_list() 会检查元素值吗？

不会。它只看键是否为 0 到 count-1 的连续整数，元素类型和内容需要业务代码另行检查。

什么时候该用 array_values()？

当删除、过滤或排序后的结果必须以 JSON 列表或重新编号的数组输出时使用；如果键名承载业务含义，就应该保留原键。

把判断规则写进测试

一个小测试表就能避免后续重构把列表语义弄丢：

 true,
    [0 => 'a', 1 => 'b'] => true,
    [1 => 'a'] => false,
    [0 => 'a', 2 => 'b'] => false,
];

实际测试中请用 PHPUnit 的数据提供器表达这些样例，尤其要覆盖 `unset()` 后的缺口键和数字键与字符串键混合的情况。这样，函数选型就从个人习惯变成了可验收的接口约束。