php怎么生成json数据_php将数据编码为json格式

看不見的法師

发布时间：2025-09-22 23:14:01

591人浏览过

来源于php中文网

原创

PHP中使用json_encode()将数组或对象转为JSON字符串，支持多种标志如JSON_PRETTY_PRINT、JSON_UNESCAPED_UNICODE等优化格式，需确保数据为UTF-8编码并处理可能的错误。

php怎么生成json数据_php将数据编码为json格式

在PHP中，将数据编码为JSON格式的核心方法是使用内置的

json_encode()

函数。这个函数能够将PHP的数组或对象转换成符合JSON标准的字符串，是构建API接口、数据存储或前后端通信时不可或缺的工具。

解决方案

PHP提供了一个非常直接且强大的函数来处理JSON编码，那就是

json_encode()

。这个函数能够接收一个PHP变量（通常是数组或对象），并尝试将其转换为JSON格式的字符串。如果转换成功，它会返回一个JSON字符串；如果失败，则返回

false

。

举个最简单的例子，如果你有一个PHP数组：

 '张三',
    'age' => 30,
    'isStudent' => false,
    'hobbies' => ['coding', 'reading', 'travel'],
    'address' => null
];

$json_string = json_encode($data);

if ($json_string === false) {
    echo "JSON编码失败: " . json_last_error_msg();
} else {
    echo $json_string;
}
?>

这段代码会输出：

{"name":"张三","age":30,"isStudent":false,"hobbies":["coding","reading","travel"],"address":null}

可以看到，PHP数组被完美地映射成了JSON对象。数值、布尔值、字符串、null以及嵌套的数组（在JSON中对应数组）都被正确处理。在我看来，它的简洁性和高效性，让它成为了PHP开发者的首选。

立即学习“PHP免费学习笔记（深入）”；

PHP

json_encode()

函数的基本用法和常见场景

json_encode()

的基本用法就像上面展示的那样，直接传入你要编码的数据即可。但它还有第二个参数

$flags

，这才是真正让它变得灵活的地方。这些标志（flags）允许我们控制JSON输出的格式和行为，这在很多实际场景中都非常有用。

我个人最常用的一些

$flags

包括：

JSON_PRETTY_PRINT
: 这个标志会让输出的JSON字符串带有缩进和换行，使其更易读。调试API响应时，我几乎总是会加上它。

$data = ['id' => 1, 'name' => 'Product A'];
echo json_encode($data, JSON_PRETTY_PRINT);
// 输出：
// {
//     "id": 1,
//     "name": "Product A"
// }

JSON_UNESCAPED_UNICODE
: 当你的数据中包含中文或其他非ASCII字符时，PHP默认会将它们转义成
```
\uXXXX
```
的形式。虽然这在技术上是正确的，但会增加JSON字符串的长度，并且在某些情况下阅读起来不太直观。加上这个标志，中文就会直接显示为中文。这对于处理国际化内容或纯中文API响应来说，简直是福音。
```
$data = ['message' => '你好，世界！'];
echo json_encode($data); // {"message":"\u4f60\u597d\uff0c\u4e16\u754c\uff01"}
echo json_encode($data, JSON_UNESCAPED_UNICODE); // {"message":"你好，世界！"}
```

JSON_UNESCAPED_SLASHES
: 如果你的数据中包含斜杠（

），

json_encode()

默认也会对其进行转义。这个标志可以阻止这种行为，让URL等路径看起来更干净。

$data = ['url' => 'http://example.com/path/to/resource'];
echo json_encode($data); // {"url":"http:\/\/example.com\/path\/to\/resource"}
echo json_encode($data, JSON_UNESCAPED_SLASHES); // {"url":"http://example.com/path/to/resource"}

JSON_NUMERIC_CHECK
: 这个标志会把所有数字字符串（例如 "123"）自动转换成数字类型。在处理一些从数据库读取的数据时，字段类型可能都是字符串，但你希望它们在JSON中是数字，这个就很有用。
```
$data = ['id' => '123', 'price' => '99.50'];
echo json_encode($data); // {"id":"123","price":"99.50"}
echo json_encode($data, JSON_NUMERIC_CHECK); // {"id":123,"price":99.5}
```
JSON_FORCE_OBJECT
: 有时候你可能有一个空数组
```
[]
```
，但你希望它被编码成一个空JSON对象
```
{}
```
而不是空JSON数组
```
[]
```
。这个标志就能帮你实现。这在某些API规范中可能会有要求。
```
$data = [];
echo json_encode($data); // []
echo json_encode($data, JSON_FORCE_OBJECT); // {}
```

这些标志可以组合使用，用

运算符连接起来，例如

JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE

。

常见场景嘛，最普遍的就是API接口的响应。当你的后端需要给前端或者其他服务返回数据时，JSON是标准格式。另外，将配置数据或临时数据存储到文件系统时，JSON也是一个轻量级且易于解析的选择。有时候，我也会用它来序列化一些简单的PHP对象，方便在不同进程间传递。

处理

json_encode()

可能遇到的编码问题和错误

虽然

json_encode()

大部分时候都很好用，但它也不是万能的，踩坑是常有的事。最常见的错误就是

json_encode()

false

，或者返回一个空字符串

""

。这时候，你肯定会抓耳挠腮，不知道哪里出了问题。

解决这类问题的关键在于使用

json_last_error()

和

json_last_error_msg()

这两个函数。它们能告诉你为什么编码失败了。

 $invalid_string];

$json_string = json_encode($data);

if ($json_string === false) {
    echo "JSON编码失败！错误码：" . json_last_error() . "，错误信息：" . json_last_error_msg();
} else {
    echo $json_string;
}
?>

运行这段代码，你可能会得到类似 "JSON编码失败！错误码：5，错误信息：Malformed UTF-8 characters, possibly incorrectly encoded" 的输出。错误码

对应

JSON_ERROR_UTF8

，这明确指出了问题所在：输入数据中包含了非UTF-8编码的字符。

使用JSON进行网络数据交换传输中文WORD版

本文档主要讲述的是使用JSON进行网络数据交换传输；JSON（JavaScript ObjectNotation）是一种轻量级的数据交换格式，易于阅读和编写，同时也易于机器解析和生成，非常适合于服务器与客户端的交互。JSON采用与编程语言无关的文本格式，但是也使用了类C语言的习惯，这些特性使JSON成为理想的数据交换格式。和 XML 一样，JSON 也是基于纯文本的数据格式。由于 JSON 天生是为 JavaScript 准备的，因此，JSON的数据格式非常简单，您可以用 JSON 传输一个简单的 St

下载

常见的错误原因及解决方案：

非UTF-8编码的字符串: 这是最最常见的问题。JSON规范要求字符串必须是UTF-8编码。如果你的数据源（比如数据库、文件）不是UTF-8，或者你在处理过程中引入了其他编码的字符串，
```
json_encode()
```
就会失败。
- 解决方案: 确保所有要编码的字符串都是UTF-8编码。你可以使用
```
mb_convert_encoding()
```
  或
```
iconv()
```
  函数将字符串转换为UTF-8。
```
$data['message'] = mb_convert_encoding($data['message'], 'UTF-8', 'GBK'); // 假设原始是GBK
$json_string = json_encode($data);
```

深度限制:

json_encode()

默认的递归深度是512层。如果你有一个非常深的嵌套数组或对象，可能会超出这个限制。

解决方案: 增加

json_encode()

的第三个参数

$depth

。

$deep_data = create_deep_array(600); // 假设这是一个600层深的数组
$json_string = json_encode($deep_data, 0, 1000); // 允许1000层深度

循环引用: 虽然
```
json_encode()
```
通常能避免简单的循环引用（因为它处理的是值而不是引用），但在某些复杂对象图或自定义序列化逻辑中，仍然可能出现问题。这会导致无限递归或内存溢出。
- 解决方案: 在编码前检查并打破循环引用，或者实现
```
JsonSerializable
```
  接口来自定义对象的序列化方式。

我个人在调试这类问题时，通常会先

var_dump()

一下要编码的数据，看看有没有什么奇怪的字符或者结构。配合

json_last_error_msg()

，定位问题通常会快很多。

优化

json_encode()

性能与输出格式的技巧

在日常开发中，我们不仅要让

json_encode()

能用，还得让它用得好，用得高效。尤其是在处理大量数据或者高并发场景下，一些优化技巧就显得尤为重要。

选择合适的
```
$flags
```
:
- 生产环境避免
  JSON_PRETTY_PRINT
  : 调试时
```
JSON_PRETTY_PRINT
```
  确实方便，但它会增加JSON字符串的体积，从而增加网络传输开销和解析时间。在生产环境中，除非有特殊需求，否则通常不使用它。
- 根据需求使用
  JSON_UNESCAPED_UNICODE
  和
  JSON_UNESCAPED_SLASHES
  : 如果你的JSON字符串中包含大量中文或URL，使用这两个标志可以有效减少字符串长度，提升传输效率。当然，这也会稍微增加编码时的CPU开销，但通常是值得的。

过滤不必要的数据: 在将数据传递给

json_encode()

之前，先确保你只包含了客户端真正需要的数据。比如，一个用户对象可能包含密码哈希、内部ID等敏感或不必要的信息。在编码前，创建一个只包含公开字段的新数组或对象。

class User {
    public $id;
    public $username;
    private $password_hash; // 私有属性不会被json_encode自动编码
    public $email;

    public function __construct($id, $username, $password_hash, $email) {
        $this->id = $id;
        $this->username = $username;
        $this->password_hash = $password_hash;
        $this->email = $email;
    }

    // 如果需要更精细控制，可以实现 JsonSerializable 接口
    public function jsonSerialize() {
        return [
            'id' => $this->id,
            'username' => $this->username,
            'email' => $this->email
        ];
    }
}

$user = new User(1, 'john_doe', 'hashed_password', 'john@example.com');
// 使用 JsonSerializable 接口
echo json_encode($user, JSON_PRETTY_PRINT);
// 输出只会包含 id, username, email

或者，手动构建一个用于输出的数组：

$user_data = [
    'id' => $user->id,
    'username' => $user->username,
    'email' => $user->email
];
echo json_encode($user_data, JSON_PRETTY_PRINT);

这不仅能减小JSON体积，还能避免泄露敏感信息。

实现
```
JsonSerializable
```
接口: 对于复杂的PHP对象，如果你想自定义它们如何被
```
json_encode()
```
序列化，可以实现
```
JsonSerializable
```
接口。这会让你对输出的JSON结构有更细粒度的控制。在我的经验中，这对于那些内部结构复杂，但对外只需要暴露部分属性的对象来说，非常实用。
```
// 上面 User 类的例子已经展示了 JsonSerializable 的用法。
```
处理大文件或流式输出:
```
json_encode()
```
会一次性将所有数据加载到内存中并进行编码。如果你的数据量非常庞大（比如几百MB甚至GB），这可能会导致内存溢出。在这种极端情况下，你可能需要考虑流式JSON处理，而不是一次性编码。虽然PHP的
```
json_encode()
```
本身不支持流式输出，但可以通过自定义逻辑或第三方库来实现，例如逐行读取数据并输出为JSON数组的元素，或者使用像
```
Spatie\JsonStreamer
```
这样的库。这是一种更高级的优化，但在处理大数据时，确实需要考虑。