PHP json_encode 高级用法：提升数据处理效率

发布日期： 2025-10-24 阅读量： 作者： admin

今天跟大家聊聊我最近用PHP搞`json_encode`的一些心得。这玩意儿，说简单也简单，但真用起来，坑还真不少，我一步一个脚印，慢慢趟平，现在跟大家分享一下。

我接到个需求，要把PHP数组转成JSON格式，给前端那边用。心想，这还不简单？直接上`json_encode()`就完事了。结果一跑，发现事情没那么简单。

就是中文乱码问题。这应该是新手最容易遇到的坑了。默认情况下，`json_encode()`对中文支持不太友直接转过去，前端那边显示的就是一堆乱码。怎么办？我查了下资料，发现加个`JSON_UNESCAPED_UNICODE`参数就行了。就像这样：

$data = array('name' => '张三', 'age' => 30);
$json = json_encode($data, JSON_UNESCAPED_UNICODE);
echo $json; // 输出: {"name":"张三","age":30}

搞定！中文显示正常了。但是，新的问题又来了。有些数组里的数据是`null`，转成JSON后，就变成了`null`字符串。前端那边拿到`null`字符串，又要做额外的判断，挺麻烦的。我就想，能不能把`null`直接转成JSON里的`null`值？

研究了半天，发现`json_encode()`本身没有直接的参数可以控制`null`的转换。那怎么办？只能自己想办法了。我的思路是，在`json_encode()`之前，先把数组里的`null`值替换成`null`常量。就像这样：

function replace_nulls_with_null_constant($data) {
foreach ($data as $key => $value) {
if ($value === null) {
$data[$key] = null; // 注意这里，直接赋值null
} elseif (is_array($value)) {
$data[$key] = replace_nulls_with_null_constant($value); // 递归处理多维数组
return $data;

然后：

$data = array('name' => '李四', 'city' => null);
$data = replace_nulls_with_null_constant($data);
$json = json_encode($data, JSON_UNESCAPED_UNICODE);
echo $json; // 输出: {"name":"李四","city":null}

这下前端拿到的就是真正的JSON `null`值了，方便多了。不过这个方法有个缺点，就是如果数组层级很深，递归处理会比较慢。如果数据量很大，就要考虑优化一下这个函数。

还有个小技巧，就是关于对象转JSON。有时候，我们会把PHP对象也用`json_encode()`来转JSON。但是，默认情况下，`json_encode()`会将对象的所有public属性都转成JSON。如果有些属性我们不想暴露给前端，怎么办？

我的做法是，在对象里定义一个`jsonSerialize()`方法。这个方法是PHP内置的`JsonSerializable`接口的一部分。`json_encode()`在处理对象时，如果发现对象实现了`JsonSerializable`接口，就会调用`jsonSerialize()`方法来获取JSON数据。我们可以在`jsonSerialize()`方法里，自定义哪些属性需要转成JSON，哪些不需要。

就像这样：


class User implements JsonSerializable {
private $id;
public $name;
private $password;
public function __construct($id, $name, $password) {
$this->id = $id;
$this->name = $name;
$this->password = $password;

public function jsonSerialize() {
return [
'id' => $this->id,
'name' => $this->name,



$user = new User(1, '王五', '123456');
$json = json_encode($user, JSON_UNESCAPED_UNICODE);
echo $json; // 输出: {"id":1,"name":"王五"}  密码password没有被输出

这样，我们就可以精确控制对象转JSON的内容了。

`json_encode()`虽然是个小函数，但用起来还是有不少细节需要注意的。只有掌握了这些细节，才能避免踩坑，提高开发效率。

总结一下我这回实践的几个要点：

中文乱码：使用`JSON_UNESCAPED_UNICODE`参数。
`null`值处理：用自定义函数替换成`null`常量。
对象转JSON：实现`JsonSerializable`接口，自定义`jsonSerialize()`方法。

希望我的分享能帮到大家！

上一篇: 公司专业网页设计哪家强？看完这几点你就清楚了

下一篇: 还在花钱做优化？教你几招网站免费优化技巧

PHP json_encode 高级用法：提升数据处理效率

随便看看