PHP过滤空数组技巧分享

PHP中过滤空数组并非调用filter_var()就能解决的简单任务，而是一个需要精准理解类型判断、语义化“空值”定义和分层处理逻辑的实战问题：既要安全识别完全为空的数组（如[]或null），避免is_array()与count()缺失导致的警告或误判；又要谨慎清理内部元素，在保留0、'0'、false等有效业务值的前提下剔除真正的空字符串、null等无意义数据；面对多维结构还需递归控制，兼顾性能与健壮性——核心在于抛弃“万能函数”幻想，根据字段实际语义定义“什么是空”，再组合PHP原生能力精准落地。

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，你只想保留“真数组且非空”。

推荐写法：

$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 对象无效

本篇关于《PHP过滤空数组技巧分享》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！