PHP array_filter 怎么保留键名：空值判断、回调签名与 JSON 数组陷阱

接口把一批订单字段交给 PHP 清洗时，最容易被忽略的不是过滤条件，而是过滤后的键名。array_filter() 默认保留原键，删掉中间元素后再直接 json_encode()，结果可能从预期的 JSON 数组变成 JSON 对象。处理这类数据时，先决定“要不要保留键”，再决定“什么算空值”，比事后修响应格式稳得多。

为什么过滤后的 PHP 数组会突然变成 JSON 对象

先看大家常碰到的字段清洗场景：前端提交的筛选条件里，空字符串不需要拼入查询语句，但原有字段的顺序和键名还要保留，不能打乱数组原本的语义逻辑。

 'paid',
    'keyword' => '',
    'page' => 2,
];

$result = array_filter($filters);
echo json_encode($result, JSON_UNESCAPED_UNICODE);
// {"status":"paid","page":2}
?>

keyword 被移除后，剩下的是带字符串键的关联数组，编码成 JSON 对象完全正常。如果输入是数字键，情况更容易误判：

 10, 2 => 12]
echo json_encode($filtered); // {"0":10,"2":12}
?>

这里不是 array_filter() 把值改成了对象，而是 PHP 数组仍然保留了不连续的数字键。只要接口契约要求 JSON 数组，就把重排键名作为最后一步。

默认过滤到底删掉哪些值

不传回调时，array_filter() 会把值转换为布尔值后判断。空字符串、字符串 "0"、整数 0、浮点数 0.0、false、null 和空数组都会被过滤。这个规则方便，但不一定符合业务含义。

例如订单接口里的 page=0 可能是非法页码，也可能是内部游标。不要为了省一行代码直接使用默认过滤，先把允许的值写出来。

需要同时检查值和键名时，回调签名怎么写

默认情况下，回调只收到一个值。使用键名时要显式传入 ARRAY_FILTER_USE_BOTH；如果只想接收键名，则使用 ARRAY_FILTER_USE_KEY。

 '  Lin  ',
    'email' => '',
    'age' => 0,
    'debug' => false,
];

$clean = array_filter(
    $payload,
    static function (mixed $value, string $key): bool {
        if ($key === 'age') {
            return is_int($value) && $value >= 0;
        }

        return is_string($value) && trim($value) !== '';
    },
    ARRAY_FILTER_USE_BOTH
);

var_dump($clean);
// name => "  Lin  ", age => 0
?>

这里保留了年龄为 0 的值，却过滤了空邮箱和 false 调试开关。回调返回的是“保留”条件，不是“删除”条件；变量名最好用 shouldKeep 一类的语义，能少一次反向理解。

过滤后要不要 array_values，取决于输出协议

如果过滤后的数组只在 PHP 内部按键名读取，原始键名大多有留存价值；如果结果要转成 JSON 数组、渲染分页列表或者传给前端做下拉选项，就应该把下标重排成连续序列：

 101, 'enabled' => true],
    ['id' => 102, 'enabled' => false],
    ['id' => 103, 'enabled' => true],
];

$enabled = array_values(array_filter(
    $items,
    static fn (array $item): bool => $item['enabled'] === true
));

echo json_encode($enabled, JSON_UNESCAPED_UNICODE);
// [{"id":101,"enabled":true},{"id":103,"enabled":true}]
?>

一个实用判断是：后续代码是否会用 $result[$id] 取值？如果会，保留键；是否会把结果当作“第 0、1、2 项”传给 JavaScript？如果会，先 array_values()。不要为了“看起来整齐”无条件重排，键名可能正是数据关联关系的一部分。

嵌套数组和引用变量的两个边界

array_filter() 只过滤当前这一层，不会自动递归。要清理嵌套结构，应明确递归规则，否则可能把内部空值误当成整行无效。

另外，回调里不要依赖外部可变引用去记录计数。过滤回调的职责最好只有一个：根据当前值和键名返回布尔结果。需要统计被过滤数量时，先保存原数组数量，或在过滤前后用 count() 对比，避免回调副作用让结果难以测试。

上线前的检查清单

• 是否明确了 0、"0"、空格字符串和 false 的业务含义？
• 是否需要键名？需要时是否传了正确的 ARRAY_FILTER_USE_* 标志？
• JSON 输出是对象还是数组，是否与接口文档一致？
• 是否为全空输入、嵌套数组和回调异常补了测试？

相关问题

array_filter 会修改原数组吗？

不会。它返回一个新数组，原数组保持不变；但数组元素如果是对象，对象本身仍然是同一个引用语义。

怎么只按键名过滤？

传入回调并使用 ARRAY_FILTER_USE_KEY，回调只接收键名，适合白名单字段筛选。

过滤结果为什么不是连续下标？

因为 array_filter() 保留原键。需要连续数字下标时，在过滤结果外层调用 array_values()。

把过滤规则写成接口契约

array_filter() 本身并不复杂，真正容易出错的是把“PHP 的 false 规则”“字段业务规则”和“JSON 的数组语义”混在了一起。把回调写成可读的保留条件，最后再根据输出协议决定是否重排键名，代码和测试都会更稳定。