PHP空数组转JSON处理技巧

本文深入解析了PHP中空数组经json_encode()转换为JSON时产生的空对象“{}”或空数组“[]”等不符合预期的输出问题，并系统介绍了五种实用解决方案：通过empty()手动控制返回格式、用array_filter()预处理剔除空值、自定义类智能区分索引/关联空数组、借助JSON_FORCE_OBJECT强制统一输出对象、以及结合JSON_THROW_ON_ERROR机制实现异常感知下的空值干预；无论你是对接严格API规范、处理含中文的国际化数据，还是追求项目级空数组行为一致性，这些方法都能帮你精准掌控JSON序列化结果，避免前端解析出错或接口兼容性隐患。

当PHP数组为空时，使用json_encode()函数编码会生成空JSON对象或空JSON数组，具体取决于数组类型。以下是处理空数组转JSON时出现空值问题的多种方法：

一、判断数组是否为空并手动返回指定JSON字符串

在调用json_encode()前检测数组是否为空，避免默认输出不符合预期的空结构。该方法适用于需严格控制JSON输出格式的场景。

1、使用empty()函数检查数组是否为空。

2、若为空，则直接返回所需JSON字符串，例如"[]"或"{}"。

3、若不为空，则调用json_encode()进行正常编码。

二、使用array_filter()预处理数组去除空值再编码

array_filter()可清除数组中值为false、null、0、""等“空”元素，从而避免编码后出现冗余空字段。该方法适用于关联数组中存在可忽略的空键值对的情形。

1、对原始数组调用array_filter()，保留非空值。

2、对过滤后的数组再次调用json_encode()。

3、注意：默认array_filter()会保留键名，如需重置索引，需额外调用array_values()。

三、自定义JSON编码类封装空数组逻辑

通过继承或封装方式扩展json_encode行为，使空索引数组始终输出为"[]"，空关联数组始终输出为"{}"。该方法适用于项目中多处需统一空数组JSON表现的场景。

1、定义函数判断数组是否为索引数组且为空，或是否为关联数组且为空。

2、根据判断结果分别返回"[]"或"{}"。

3、对非空数组调用原生json_encode()并返回结果。

四、使用JSON_UNESCAPED_UNICODE与JSON_FORCE_OBJECT组合控制输出

JSON_FORCE_OBJECT参数可强制将空索引数组编码为对象形式，配合JSON_UNESCAPED_UNICODE确保中文不被转义。该方法适用于需将所有数组（含空数组）统一视为对象处理的接口规范。

1、在json_encode()第二个参数中传入JSON_FORCE_OBJECT | JSON_UNESCAPED_UNICODE。

2、此时空数组将输出为"{}而非"[]"。

3、注意：该方式会改变所有数组的JSON结构类型，需确认下游系统兼容性。

五、利用JSON_THROW_ON_ERROR捕获编码异常并干预空值输出

PHP 7.3+支持JSON_THROW_ON_ERROR标志，可在json_encode()失败时抛出异常。虽然空数组本身不会触发异常，但可结合自定义错误处理器，在编码前后插入空值校验逻辑。

1、启用JSON_THROW_ON_ERROR选项调用json_encode()。

2、使用try-catch捕获潜在异常（如资源限制导致的编码失败）。

3、在catch块外添加空数组判定分支，对空数组返回预设JSON字符串，例如"null"或"[]" 。

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