filter_var() 不支持数组过滤,仅处理标量值;判断非空数组应先 is_array() 再 count() > 0;清理内部空元素需自定义 Array_Filter 回调,注意保留 0/’0′ 等有效值。

filter_var() 不能直接过滤空数组,别踩这个坑
很多人看到 filter_var() 能校验字符串、整数、邮箱,就以为它也能“过滤掉空数组”,结果传入 [] 或 [NULL, ''],函数直接返回原值甚至报 NULL —— 因为它根本不支持 array 类型校验。php 官方文档明确写了:该函数只处理标量(scalar)值。
真正该用的是语言内置的判断逻辑 + 数组函数组合。关键不是“过滤”,而是“识别并剔除”:
-
empty($arr)可判断数组是否为空([]),但对[0, false, '']这类含“falsy 元素”的数组会误判 -
count($arr) === 0最安全,只看长度,不关心内容 - 要过滤“含空元素的数组”,得用
array_filter($arr),但它默认会删掉所有 falsy 值(包括0、false、''),未必符合业务需求
过滤掉完全空的数组([])和 null/undefined 类似值
这是最常见场景:API 返回可能为 null、[]、false,你只想保留“真数组且非空”。
推荐写法:
立即学习“PHP免费学习笔记(深入)”;
$data = get_api_response(); // 可能是 null, [], 或 [1,2,3] if (is_array($data) && count($data) > 0) { // 安全使用 $data }
注意点:
- 必须先
is_array(),否则count(null)会触发 warning(PHP 8+ 是TypeError) - 不要用
!empty($data)替代,因为empty([0])是true,但[0]显然不是空数组 - 如果上游可能返回
'[]'字符串,需额外json_decode($str, true)并检查是否为 array
清理数组内部的空值(如 ”, null, false),但保留 0 和 ‘0’
默认 array_filter($arr) 会把 0、'0'、false 全干掉,这在处理表单或配置时经常出错——比如用户填了价格 0,你不该当成空删掉。
正确做法是显式定义“什么是空”:
$clean = array_filter($arr, function($v) { return $v !== '' && $v !== null && $v !== false; });
更通用的封装:
function filter_array_falsy_but_keep_zeros($arr) { return array_filter($arr, function($v) { return !is_string($v) || trim($v) !== ''; }); }
说明:
- 上面函数只把空字符串(含纯空白)当空,
0、'0'、false全部保留 - 如果还要兼容
0.0、0.00等数字零值,需加is_numeric($v) && $v == 0判断分支 - 性能上,
array_filter会重建键名,如需保持原键,加第三个参数ARRAY_FILTER_USE_BOTH自行控制
递归过滤多维数组里的空元素
遇到 ['name' => 'Tom', 'tags' => ['', null, []], 'meta' => ['id' => 0]] 这种结构,简单一层 array_filter 不够用。
手写递归函数更可控:
function array_filter_recursive($arr, callable $callback = null) { foreach ($arr as $k => $v) { if (is_array($v)) { $arr[$k] = array_filter_recursive($v, $callback); } } return $callback ? array_filter($arr, $callback) : array_filter($arr); } // 仅删空字符串和 null,保留 0/'0'/false $clean = array_filter_recursive($data, function($v) { return $v !== '' && $v !== null; });
注意边界:
- 递归前务必加
is_array($v)防止无限循环(比如对象、资源句柄) - PHP 7.4+ 支持
...$arr展开,但这里不用,避免深度嵌套爆栈;实际项目中建议加递归深度限制(如超过 10 层直接返回原值) - 若数组含对象且需处理其 public 属性,得单独用
get_object_vars()转换,array_filter_recursive对象无效
有些过滤逻辑看着简单,比如“去掉空值”,但一碰到 0、'0'、false、0.0 就容易翻车。关键不是找一个万能函数,而是根据字段语义决定“空”的定义——是“无输入”,还是“未设置”,还是“显式清零”。