PHP去除JSON空值的实用技巧

PHP 的 json_encode() 默认保留 null 值，无法自动剔除空字段，导致输出 JSON 中出现冗余的 `"key": null`，而前端常期望直接省略该字段；本文深入剖析了安全清理空值的核心难点——既要精准剔除 `null`（及按需处理 `''`、`[]` 等），又必须严防误删 `0`、`false`、`"0"` 等具有明确业务语义的有效值，并给出递归 `array_filter` 配合 `ARRAY_FILTER_USE_BOTH` 的可控方案，同时指出在复杂场景下，采用 DTO 类或 `JsonSerializable` 实现细粒度序列化控制才是更健壮、可维护、易测试的工程化实践。

PHP json_encode() 默认保留 null 值，无法自动过滤

PHP 的 json_encode() 不会主动剔除数组中的 null 值或空字符串、空数组等“空值”，它只做类型映射：PHP null → JSON null。如果你期望输出的 JSON 里完全不出现某个字段（而非设为 null），必须在编码前手动清理数据结构。

常见错误现象：json_encode(['name' => 'Alice', 'age' => null]) 输出 {"name":"Alice","age":null}，但前端可能期望直接省略 age 字段。

• 不能依赖 JSON_FORCE_OBJECT 或 JSON_UNESCAPED_UNICODE 等标志来过滤空值
• array_filter() 默认会移除 false、0、""、null，但会重置数字键，导致关联数组变索引数组 —— 这在嵌套结构中极易引发意外
• 若需保留键名，必须显式传入 ARRAY_FILTER_USE_BOTH 并自定义回调

用 array_filter() + 自定义回调安全剔除空值

最常用且可控的方式是递归清理数组，对每个值判断是否属于“应剔除的空值”。注意：仅移除 null 是不够的，业务中常还需处理 ''、[]、0（视场景而定）。

function removeEmptyValues($data) {
    return array_map(function ($item) {
        if (is_array($item)) {
            $item = removeEmptyValues($item);
        }
        return $item;
    }, array_filter($data, function ($value, $key) {
        // 明确排除 null；如需同时排除空字符串/空数组，可扩展条件
        return $value !== null;
    }, ARRAY_FILTER_USE_BOTH));
}

使用示例：json_encode(removeEmptyValues(['a' => 'ok', 'b' => null, 'c' => ['x' => null]])) → {"a":"ok","c":{}}。注意：空数组 [] 仍保留，如需进一步清除，需在回调中加 !is_array($value) || !empty($value) 判断。

注意 0、false、"0" 的语义差异

业务中容易误删有效数据。例如用户年龄为 0、开关状态为 false、订单号为字符串 "0"，它们在松散比较下都等价于空，但语义完全不同。

• 不要无差别用 empty() 或 !$value 做过滤 —— 它会把 0、"0"、false 全干掉
• 推荐显式枚举需剔除的值：$value === null || $value === '' || (is_array($value) && empty($value))
• 若字段有明确类型契约（如 API 文档规定某字段只允许 string/number），应在清理前先做类型校验，而非靠过滤兜底

复杂嵌套结构建议用 DTO 类 + 序列化控制

当数据来源多样（数据库、API、表单）、结构深且规则不一时，硬写递归 array_filter 易出错、难维护。更稳健的做法是封装成类，用属性可见性或注解控制序列化行为。

例如用 Laravel 的 toArray() 或 Symfony 的 Serializer 组件，配合 @Groups 或 Ignore 注解跳过特定属性；或手写一个 JsonSerializable 实现：

class User implements JsonSerializable {
    public $name;
    public $age;
    public $avatar;

    public function jsonSerialize() {
        return array_filter([
            'name' => $this->name,
            'age' => $this->age !== null ? $this->age : null, // 显式控制
            'avatar' => $this->avatar ?: null,
        ], function ($v) { return $v !== null; });
    }
}

这种写法把“哪些字段该出现、何时为空”逻辑收束到类内部，比全局过滤函数更清晰，也更容易单元测试。

真正麻烦的不是怎么删 null，而是搞清哪个 null 是缺省值、哪个是业务上有效的“未设置”、哪个又该转成默认字符串——这些边界往往藏在需求文档角落，而不是代码里。

理论要掌握，实操不能落！以上关于《PHP去除JSON空值的实用技巧》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！