当前位置：首页 > 文章列表 > 文章 > php教程 > PHP数组转JSON字符串的实用方法

PHP数组转JSON字符串的实用方法

2025-09-24 14:57:32 0浏览收藏

哈喽！今天心血来潮给大家带来了《PHP数组转JSON字符串方法详解》，想必大家应该对文章都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习文章，千万别错过这篇文章~希望能帮助到你！

PHP使用json_encode()将数组转为JSON字符串，json_decode()将JSON字符串解析为数组或对象；处理中文需添加JSON_UNESCAPED_UNICODE避免转义，JSON_PRETTY_PRINT可格式化输出；注意数据类型映射、错误检查、深度限制及大整数精度问题，确保安全与性能。

PHP如何将数组转换为JSON字符串_PHP数组与JSON格式相互转换的方法

PHP将数组转换为JSON字符串，主要依赖于内置的json_encode()函数；反之，将JSON字符串解析回PHP数组或对象，则使用json_decode()函数。这两个函数是PHP处理数据序列化和反序列化，尤其是与前端或其他API交互时的核心工具。

解决方案

在PHP中，将数组转换为JSON字符串是一个非常直接的过程。你只需要调用json_encode()函数，并传入你的PHP数组即可。这个函数会返回一个JSON格式的字符串。如果转换失败，它会返回false。

<?php
// 一个简单的PHP关联数组
$data = [
    'name' => '张三',
    'age' => 30,
    'isStudent' => false,
    'hobbies' => ['reading', 'coding', 'travel'],
    'address' => [
        'city' => '北京',
        'zip' => '100000'
    ]
];

// 将数组转换为JSON字符串
// 这里使用了JSON_UNESCAPED_UNICODE来防止中文被转义，
// JSON_PRETTY_PRINT让输出更易读（调试时非常有用）
$jsonString = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);

if ($jsonString === false) {
    echo "JSON编码失败: " . json_last_error_msg();
} else {
    echo "转换后的JSON字符串:\n";
    echo $jsonString;
}

echo "\n\n";

// 这是一个JSON字符串，通常从API响应或文件读取
$jsonInput = '{"product":"Laptop","price":1200.50,"specs":{"cpu":"i7","ram":"16GB"},"inStock":true}';

// 将JSON字符串转换为PHP数组
// 传入true作为第二个参数，会强制返回关联数组而不是对象
$decodedArray = json_decode($jsonInput, true);

if (json_last_error() !== JSON_ERROR_NONE) {
    echo "JSON解码失败: " . json_last_error_msg();
} else {
    echo "解码后的PHP数组:\n";
    print_r($decodedArray);
}

echo "\n\n";

// 如果不传入true，则会返回PHP对象
$decodedObject = json_decode($jsonInput);
echo "解码后的PHP对象:\n";
print_r($decodedObject);
?>

json_encode()函数接受第二个参数，即一组位掩码选项，用于控制编码行为。我个人经常使用的包括：

JSON_UNESCAPED_UNICODE：这对于包含中文的字符串非常关键，它会阻止中文被转义成\uXXXX的形式，让JSON更易读且体积略小。
JSON_PRETTY_PRINT：在开发和调试阶段，这个选项能让JSON输出格式化，带有缩进和换行，看起来一目了然。生产环境中通常会移除，以减少传输体积。
JSON_NUMERIC_CHECK：尝试将数字字符串编码为JSON数字类型，而不是字符串。这有时会导致意想不到的行为，所以使用时需要谨慎。

json_decode()函数同样接受第二个参数。当设置为true时，它会将JSON对象转换为PHP关联数组；如果省略或设置为false，则转换为PHP标准对象（stdClass）。第三个参数是depth，用于限制递归深度，防止解析恶意构造的深度嵌套JSON导致内存耗尽。第四个参数是options，比如JSON_BIGINT_AS_STRING，这在处理JavaScript无法精确表示的大整数时非常有用，可以避免数据精度丢失，直接将其作为字符串处理。

PHP数组转JSON时，如何避免中文乱码或转义问题，并优化输出格式？

处理中文时，最常见的“问题”就是json_encode()默认会将非ASCII字符转义成\uXXXX的形式。这并非乱码，而是JSON标准允许的表示方式，但对于人类阅读或者某些特定场景，我们可能希望看到原始的中文。解决这个问题非常简单，就是在调用json_encode()时，传入JSON_UNESCAPED_UNICODE选项。

<?php
$dataWithChinese = [
    'title' => '你好，世界！',
    'description' => '这是一个包含中文的示例。',
    'items' => ['苹果', '香蕉', '橘子']
];

// 默认编码，中文会被转义
$defaultJson = json_encode($dataWithChinese);
echo "默认编码 (中文被转义):\n" . $defaultJson . "\n\n";
// 输出: {"title":"\u4f60\u597d\uff0c\u4e16\u754c\uff01","description":"\u8fd9\u662f\u4e00\u4e2a\u5305\u542b\u4e2d\u6587\u7684\u793a\u4f8b\u3002","items":["\u82f9\u679c","\u9999\u8549","\u6a58\u5b50"]}

// 使用 JSON_UNESCAPED_UNICODE 避免中文转义
$unescapedJson = json_encode($dataWithChinese, JSON_UNESCAPED_UNICODE);
echo "中文不转义:\n" . $unescapedJson . "\n\n";
// 输出: {"title":"你好，世界！","description":"这是一个包含中文的示例。","items":["苹果","香蕉","橘子"]}

// 结合 JSON_PRETTY_PRINT 优化输出格式
$prettyJson = json_encode($dataWithChinese, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
echo "中文不转义且格式化:\n" . $prettyJson . "\n";
/* 输出:
{
    "title": "你好，世界！",
    "description": "这是一个包含中文的示例。",
    "items": [
        "苹果",
        "香蕉",
        "橘子"
    ]
}
*/
?>

至于优化输出格式，JSON_PRETTY_PRINT就是你的最佳选择。它会为JSON字符串添加缩进和换行，使其在控制台或日志文件中更易读。当然，这会增加JSON字符串的体积，所以在生产环境中，如果对带宽或存储有严格要求，通常会选择不使用这个选项。

另一个需要注意的细节是，json_encode()要求输入的字符串是UTF-8编码。如果你的PHP数组中包含非UTF-8编码的字符串，json_encode()可能会返回false或者生成不正确的JSON。在这种情况下，你需要先使用mb_convert_encoding()等函数将字符串转换为UTF-8。编码问题往往是隐藏的坑，一旦遇到，排查起来会比较头疼。

PHP在处理不同数据类型与JSON之间的映射关系是怎样的？

PHP数组与JSON格式之间的转换，本质上是数据类型的一种映射。理解这种映射关系，对于避免数据丢失或格式错误至关重要。

PHP数据类型到JSON数据类型：

string (字符串) -> string (字符串)：这是最直接的映射。
int (整数), float (浮点数) -> number (数字)：PHP的整数和浮点数会直接转换为JSON的数字类型。
bool (布尔值) -> true 或 false：PHP的true和false会转换为JSON的布尔值。
null (空值) -> null (空值)：PHP的null会转换为JSON的null。
array (索引数组) -> array (数组)：如果PHP数组的所有键都是连续的整数（从0开始），那么它会被编码为JSON数组。例如 [0 => 'a', 1 => 'b'] 会变成 ["a", "b"]。
array (关联数组) -> object (对象)：如果PHP数组包含非连续的整数键，或者包含字符串键，它会被编码为JSON对象。例如 ['key' => 'value', 'another' => 123] 会变成 {"key": "value", "another": 123}。
object (对象) -> object (对象)：PHP对象（包括stdClass实例）会被编码为JSON对象。默认情况下，只有对象的公共（public）属性会被编码。如果需要自定义对象的序列化行为，对象可以实现JsonSerializable接口。
resource (资源), callable (可调用类型) 等其他类型 -> null：这些PHP特有的数据类型在JSON中没有直接对应，通常会被编码为null。

JSON数据类型到PHP数据类型：

string (字符串) -> string (字符串)
number (数字) -> int (整数) 或 float (浮点数)：PHP会根据数值的大小和是否有小数部分自动判断。
true 或 false -> bool (布尔值)
null (空值) -> null (空值)
array (数组) -> array (索引数组)
object (对象) -> stdClass (标准对象) 或 array (关联数组)：这取决于json_decode()的第二个参数。如果为true，则为关联数组；否则为stdClass对象。

理解这些映射关系，尤其是在处理数据库数据、API请求响应时非常重要。比如，一个纯数字的PHP索引数组，如果中间某个键不是连续的，或者变成了字符串，那么json_encode就会把它当作关联数组处理，最终在JSON中体现为对象，而不是数组。这在我以前的项目中，曾导致前端解析时出现类型错误。

<?php
// 各种数据类型的映射示例
$mixedData = [
    'string_val' => 'Hello PHP',
    'int_val' => 123,
    'float_val' => 45.67,
    'bool_true' => true,
    'bool_false' => false,
    'null_val' => null,
    'indexed_array' => ['apple', 'banana', 'cherry'],
    'associative_array' => ['name' => 'Alice', 'age' => 25],
    'object_val' => (object)['id' => 101, 'status' => 'active'],
    // 'resource_val' => fopen('php://memory', 'r'), // 资源类型会被编码为 null
    'empty_array' => [],
    'empty_object' => new stdClass(),
    'mixed_keys_array' => [0 => 'first', 2 => 'third', 'key' => 'value'] // 会被编码为对象
];

$jsonOutput = json_encode($mixedData, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
echo "混合数据类型编码为JSON:\n" . $jsonOutput . "\n\n";

// 解码回PHP
$decodedMixed = json_decode($jsonOutput, true); // 解码为关联数组
echo "JSON解码回PHP关联数组:\n";
print_r($decodedMixed);

$decodedObject = json_decode($jsonOutput); // 解码为对象
echo "\nJSON解码回PHP对象:\n";
print_r($decodedObject);
?>

从上面的例子可以看出，mixed_keys_array虽然在PHP中是数组，但因为它包含非连续整数键和字符串键，最终被json_encode处理成了JSON对象。这正是PHP数组转换为JSON对象的核心判断逻辑。

PHP解析JSON字符串时，如何处理潜在的数据安全问题和性能优化？

在接收和解析外部JSON数据时，数据安全和性能是两个不可忽视的方面。

数据安全方面：

输入验证与过滤： 永远不要信任来自外部的任何数据。在将JSON字符串传入json_decode()之前，如果JSON是用户输入的一部分，务必进行初步的字符串清理或验证。虽然json_decode()本身会处理格式不正确的JSON，但恶意构造的JSON字符串可能导致解析失败或消耗大量资源。

错误检查： json_decode()在解析失败时会返回null（或false，取决于PHP版本和错误类型）。因此，在每次调用json_decode()之后，都应该立即检查其返回值，并结合json_last_error()和json_last_error_msg()来判断是否发生了错误以及错误原因。这能有效防止程序在收到无效JSON时继续处理错误数据。

<?php
$malformedJson = '{"name":"John", "age":30, "city":"New York"'; // 缺少右大括号
$data = json_decode($malformedJson, true);

if (json_last_error() !== JSON_ERROR_NONE) {
    echo "JSON解析失败！错误信息: " . json_last_error_msg() . "\n";
    // 根据错误类型进行处理，比如记录日志、返回错误响应等
} else {
    // 安全地处理数据
    print_r($data);
}
?>

数据类型和结构验证： 即使JSON解析成功，也需要验证解码后的PHP数据结构和数据类型是否符合预期。例如，如果期望一个字段是整数，但在JSON中它是一个字符串，就可能导致后续业务逻辑出错。
深度限制： json_decode()的第三个参数depth可以限制JSON的嵌套深度。恶意用户可能会发送一个深度极高的JSON字符串，试图通过递归解析来耗尽服务器内存。设置一个合理的深度限制可以有效防御此类攻击。

性能优化方面：

避免不必要的转换： 在性能敏感的场景下，如果数据只是在PHP内部传递，并且不需要与外部系统（如前端JavaScript）交互，那么就没有必要频繁地在数组和JSON字符串之间进行转换。直接使用PHP数组或对象通常效率更高。
选择合适的解码方式： json_decode($jsonString, true)（解码为关联数组）通常比json_decode($jsonString)（解码为对象）在某些场景下性能略好，因为处理数组比处理对象可能更直接一些。但这种差异通常微乎其微，更重要的是根据业务需求选择最方便的数据结构。
处理大整数： JavaScript在处理大整数时存在精度问题（Number.MAX_SAFE_INTEGER）。如果JSON中包含超过此限制的整数，并且需要精确处理，json_decode()的第四个参数可以传入JSON_BIGINT_AS_STRING选项，将大整数解码为PHP字符串，避免精度丢失。
内存管理： 对于非常大的JSON字符串，json_decode()会一次性将整个JSON字符串加载到内存中并进行解析，这可能导致内存消耗过大。如果遇到这种情况，可能需要考虑使用流式解析器（如simps/json-rpc或自定义解析逻辑），但对于大多数Web应用场景，PHP内置的json_decode()已经足够高效。
缓存： 如果某些JSON数据是静态的或更新不频繁，可以考虑将其序列化后的JSON字符串缓存起来（例如使用Redis、Memcached或文件缓存），避免每次请求都重新生成或解析。