php去除数组空值转json的关键是明确定义“空”:仅剔除null、纯空白字符串和空数组,保留0、false、“0”等合法值,否则json api易返回错误数据。

PHP 去除数组空值后转 JSON,关键不在“转”,而在“怎么定义空”——empty() 会误删 0、"0"、false,JSON API 接口常因此返回错误数据。
为什么 array_filter() 默认行为不适合 JSON API
直接用 array_filter($arr) 会过滤掉所有被 empty() 判定为假的值,包括:0、0.0、"0"、false、null、""。但 JSON API 场景中,"0" 和 0 往往是合法业务值(如商品库存为 0、开关状态为 0)。
- 接口返回
{"status":0,"msg":"success"},若用默认array_filter,"status":0会被删掉 -
["id"=>1,"price"=>0,"desc"=>""]中,"price"消失,"desc"也消失,但语义不同:价格可为 0,描述为空才应剔除 - PHP 8.0+ 的
array_filter($arr, fn($v) => $v !== null && $v !== '')仍漏掉空白字符串变体(如" \t\n")
推荐做法:显式声明“哪些算空”,用 array_walk_recursive() 或递归函数清理
JSON API 多为嵌套结构(如 data.attributes),需深层遍历;且“空”的定义应统一为:null、纯空白字符串(trim($v) === '')、空数组(is_array($v) && count($v) === 0),而保留 0、false、"0"。
function removeEmptyValues($arr) {
return array_map(function ($v) {
if (is_array($v)) {
$v = removeEmptyValues($v);
return empty($v) && !array_keys($v) ? null : $v;
}
return ($v === null || (is_string($v) && trim($v) === '')) ? null : $v;
}, $arr);
}
// 使用后需再过滤掉 null 值(仅顶层)
$result = array_filter(removeEmptyValues($input), function($v) { return $v !== null; });
- 不依赖
empty(),避免误伤数字和布尔值 - 对字符串强制
trim(),兼容全角空格、换行等 - 空数组判为
null,但若需保留空数组(如"tags":[]是合法字段),则去掉empty($v) && !array_keys($v)这段逻辑 - 注意:该函数不处理对象,若输入含
stdClass,需先(array)$obj转换或改用json_encode(..., JSON_FORCE_OBJECT)统一路径
输出前必须检查 json_last_error()
即使数组清理干净,仍可能因 UTF-8 编码问题、循环引用(虽少见)、或超大嵌套深度导致 json_encode() 返回 false,而 JSON API 规范要求明确错误响应。
立即学习“PHP免费学习笔记(深入)”;
- 永远不要写
echo json_encode($data);就完事 - 必须加判断:
if (($json = json_encode($data)) === false) { http_response_code(500); echo json_encode(['error' => 'JSON encode failed: '.json_last_error_msg()]); exit; } - 开发期可加
JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES避免中文被编码、URL 被转义,但生产环境注意 CDN 或代理是否兼容 - 若数组含资源(如
mysqli_result)、闭包、不可序列化对象,json_encode直接静默失败,需提前unset()或转换
真正麻烦的不是“怎么删空值”,而是团队对“空”的定义是否一致——前端传 {"name":""} 算清空还是忽略?数据库字段允许 NULL 还是默认 ''?这些边界一旦没对齐,清理逻辑再严谨,API 依然会出错。










