如何在PHP中将数组保存为JSON？json_encode()函数的使用方法-php教程-PHP中文网

如何在PHP中将数组保存为JSON？json_encode()函数的使用方法

爱谁谁

发布： 2025-08-28 12:43:01

原创

992人浏览过

使用json_encode()可将PHP数组转为JSON字符串，用于数据传输和存储，支持格式化、Unicode和斜杠处理选项；转换失败时返回FALSE，可通过json_last_error()获取错误信息；json_decode()用于将JSON字符串解码为PHP变量，默认返回对象，设第二个参数为true可返回关联数组；含特殊字符的数组会自动转义，可用JSON_UNESCAPED_UNICODE等选项控制；处理大数组时应减少数据量、使用缓存、避免循环引用并选择合适选项以优化性能。

如何在php中将数组保存为json？json_encode()函数的使用方法

直接使用

json_encode()

登录后复制

函数即可将PHP数组转换为JSON字符串，方便数据传输和存储。

解决方案：

PHP提供了内置函数

json_encode()

登录后复制

，可以轻松地将PHP数组转换成JSON格式的字符串。这个函数接受一个PHP数组作为参数，并返回一个包含JSON数据的字符串。如果转换失败，则返回

FALSE

登录后复制

。

例如：

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

<?php
$my_array = array(
    'name' => 'John Doe',
    'age' => 30,
    'city' => 'New York'
);

$json_string = json_encode($my_array);

if ($json_string) {
    echo $json_string; // 输出：{"name":"John Doe","age":30,"city":"New York"}
} else {
    echo "JSON 转换失败";
}
?>

登录后复制

json_encode()

登录后复制

还有一些可选参数，可以控制JSON的输出格式，例如：

```
JSON_PRETTY_PRINT
```
登录后复制
: 格式化输出，使JSON更易读。
```
JSON_UNESCAPED_UNICODE
```
登录后复制
: 不转义Unicode字符，直接输出UTF-8编码。
```
JSON_UNESCAPED_SLASHES
```
登录后复制
: 不转义斜杠
```
/
```
登录后复制
。

使用示例：

<?php
$my_array = array(
    'name' => '张三',
    'url' => 'https://example.com/'
);

$json_string = json_encode($my_array, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

echo $json_string;
/*
输出：
{
    "name": "张三",
    "url": "https://example.com/"
}
*/
?>

登录后复制

如何处理

json_encode()

登录后复制

转换失败的情况？

json_encode()

登录后复制

转换失败通常发生在以下几种情况：

数组中包含无法转换为JSON的数据类型，例如资源类型（resource）或对象。
数组中包含循环引用。
字符串包含无效的UTF-8编码。

解决这些问题的方法包括：

数据类型检查： 在转换前，检查数组中的数据类型，确保所有数据类型都可以被JSON序列化。可以将对象转换为数组，或者将资源类型转换为字符串。
循环引用检测： 避免在数组中出现循环引用。如果必须处理包含循环引用的数据结构，可以考虑使用自定义的序列化方法。
UTF-8编码验证： 确保字符串使用有效的UTF-8编码。可以使用
```
mb_detect_encoding()
```
登录后复制
函数检测字符串编码，并使用
```
mb_convert_encoding()
```
登录后复制
函数将其转换为UTF-8编码。

如果

json_encode()

登录后复制

FALSE

登录后复制

，可以使用

json_last_error()

登录后复制

函数获取错误代码，并使用

json_last_error_msg()

登录后复制

函数获取错误信息，方便调试。

<?php
$my_array = array(
    'resource' => fopen("test.txt", "r") // 资源类型，无法转换为JSON
);

$json_string = json_encode($my_array);

if ($json_string === FALSE) {
    echo "JSON 转换失败: " . json_last_error_msg();
}
?>

登录后复制

json_decode()

登录后复制

函数如何使用？与

json_encode()

登录后复制

相反的操作

json_decode()

登录后复制

函数用于将JSON格式的字符串解码为PHP变量。它接受一个JSON字符串作为参数，并返回一个PHP变量（通常是数组或对象）。

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

基本用法：

<?php
$json_string = '{"name":"John Doe","age":30,"city":"New York"}';

$php_array = json_decode($json_string);

var_dump($php_array); // 输出：object(stdClass)#1 (3) { ["name"]=> string(8) "John Doe" ["age"]=> int(30) ["city"]=> string(8) "New York" }
?>

登录后复制

默认情况下，

json_decode()

登录后复制

将JSON对象解码为

stdClass

登录后复制

对象。如果希望将JSON对象解码为关联数组，可以将第二个参数设置为

true

登录后复制

：

<?php
$json_string = '{"name":"John Doe","age":30,"city":"New York"}';

$php_array = json_decode($json_string, true);

var_dump($php_array); // 输出：array(3) { ["name"]=> string(8) "John Doe" ["age"]=> int(20) ["city"]=> string(8) "New York" }
?>

登录后复制

与

json_encode()

登录后复制

类似，

json_decode()

登录后复制

也可能失败。如果JSON字符串无效，

json_decode()

登录后复制

将返回

NULL

登录后复制

。同样可以使用

json_last_error()

登录后复制

和

json_last_error_msg()

登录后复制

函数来获取错误信息。

如何处理包含特殊字符的数组？

当数组中包含特殊字符（例如Unicode字符、HTML标签等）时，

json_encode()

登录后复制

函数会自动进行转义。这通常是期望的行为，因为它可以确保JSON字符串的有效性。

但有时，你可能希望禁用转义，直接输出原始字符。可以使用

JSON_UNESCAPED_UNICODE

登录后复制

和

JSON_UNESCAPED_SLASHES

登录后复制

选项来控制转义行为。

例如，如果数组中包含Unicode字符：

<?php
$my_array = array(
    'name' => '你好世界'
);

$json_string = json_encode($my_array);
echo $json_string; // 输出：{"name":"\u4f60\u597d\u4e16\u754c"}

$json_string = json_encode($my_array, JSON_UNESCAPED_UNICODE);
echo $json_string; // 输出：{"name":"你好世界"}
?>

登录后复制

对于HTML标签，通常建议在前端进行转义处理，而不是在后端禁用转义。这样可以防止XSS攻击。

json_encode

登录后复制

性能优化策略

当处理大型数组时，

json_encode

登录后复制

的性能可能成为瓶颈。以下是一些优化策略：

减少数据量： 只序列化必要的数据。避免将整个数据库查询结果直接序列化，而是只选择需要的字段。
使用缓存： 如果数据不经常变化，可以将JSON字符串缓存起来，避免重复序列化。可以使用Redis、Memcached等缓存系统。
避免循环引用： 循环引用会导致
```
json_encode
```
登录后复制
陷入死循环，并最终失败。确保数据结构中没有循环引用。
选择合适的选项： 根据实际需求选择合适的
```
json_encode
```
登录后复制
选项。例如，如果不需要格式化输出，就不要使用
```
JSON_PRETTY_PRINT
```
登录后复制
选项。
考虑使用扩展： 有些扩展（例如
```
igbinary
```
登录后复制
）提供了更快的序列化和反序列化方法。