PHP过滤空值转JSON接口开发教程

本文深入剖析了PHP开发JSON API时去除数组空值的核心陷阱与最佳实践，强调真正的难点不在于技术实现，而在于精准、一致地定义“什么是空”——必须严格区分null、纯空白字符串和空数组（应剔除），同时坚决保留0、false、“0”等具有明确业务语义的合法值，避免因滥用empty()或array_filter默认行为导致关键数据丢失；文章提供了支持深层嵌套结构的健壮清理函数，并强调输出前必须校验json_encode结果、处理编码与不可序列化类型，最终指出：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 规范要求明确错误响应。

• 永远不要写 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 依然会出错。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP过滤空值转JSON接口开发教程》文章吧，也可关注golang学习网公众号了解相关技术文章。