PHP array_filter 回调不传参数时为什么会删掉零值

用 PHP 清洗表单或接口数据时，array_filter($data) 看起来像是在“去掉空值”，但它不会只盯着 null。当第二个参数省略时，array_filter 按 empty() 的判定过滤，所以数字 0 和字符串 "0" 也会被删掉。金额、库存、开关状态一旦走到这一步，后面的业务判断就会失真。

默认过滤适合“所有 PHP 空值都不要”的场景；只想删除 null 或空字符串时，必须传入显式回调。过滤结果还会保留原键名，列表接口需要连续下标时再调用 array_values()。

先把“零值被删”还原成一个最小例子

假设接口字段里同时存在库存、状态和备注，调用方只想移除真正没有提交的值：

 0,
    'enabled' => false,
    'code' => '0',
    'remark' => '',
    'memo' => null,
];

// 未传 callback 时，PHP 会按 empty() 语义删除空项。
$filtered = array_filter($fields);
print_r($filtered);

这段代码留下的通常只有非空字符串或非零数字，stock、enabled 和 code 都会消失。问题不在数组值类型，而在调用者省略了决定“什么算有效”的回调。

默认参数为什么会把 0 当成空值

PHP 手册把 callback 定义为可为空的可调用参数；没有提供回调时，数组中的 empty 项会被移除。这个规则覆盖 0、"0"、false、null、'' 和空数组等常见值。它的优点是写法短，适合把缓存字段、可选备注等“所有空值”统一清掉；缺点是无法表达“0 是有效数据”这种业务语义。

因此，看到零值消失时先检查调用签名，而不是先怀疑 PHP 类型转换。若目标是只去除未设置的字段，可以把规则写得更窄：

显式回调：把保留零值写成接口契约

当接口字段只允许“有值”与“未提交”两种状态时，可以明确排除 null 和空字符串，而不把数字零、字符串零和布尔值一并抹掉：

 is_int($value) && $value > 0
);

这里的关键是严格比较：!== 不会把数字 0 和字符串 "0" 当成同一个值。回调应描述接口的有效条件，而不是机械地套用 empty()。

过滤后还要检查键名和回调模式

array_filter 不会自动重排键名。例如索引数组删除中间元素后，结果可能是 0、2、3。这对关联数组通常是正确的，因为键名本身有业务意义；但返回 JSON 列表时，间隙下标可能被编码成对象，此时再使用：

 $item !== null);
$items = array_values($items);

如果规则依赖键名，可以传入 ARRAY_FILTER_USE_KEY；同时需要值和键时使用 ARRAY_FILTER_USE_BOTH，回调参数顺序是“值、键”。不要在回调里新增或删除原数组元素，PHP 手册明确提示这种行为未定义，排查结果会比普通条件错误更困难。

相关问题

array_filter 能只删除 0 吗？

可以传显式回调，例如只返回不等于整数 0 的值；是否同时排除字符串 "0"，要用严格比较明确写出。

为什么过滤后 JSON 结构变了？

过滤保留原键名，索引不连续时 JSON 编码可能表现为对象。列表语义下先调用 array_values() 再编码。

省略回调是不是更快？

它写法更短，但省略业务规则带来的误删成本更高。字段含有 0 或 false 时，优先选择可读的显式回调。

把 array_filter 当成一个带参数语义的 API 会更安全：先决定要删除的值集合，再决定键名是否需要重排。默认模式适合真正的空值清理，业务数据清洗则应让回调把“有效零值”写在代码里。