使用 JSON_BIGINT_AS_STRING 标志处理 JSON 中的大整数-php教程-PHP中文网

使用 JSON_BIGINT_AS_STRING 标志处理 JSON 中的大整数

花韻仙語

发布： 2025-07-12 19:04:20

原创

1000人浏览过

使用 json_bigint_as_string 标志处理 json 中的大整数

本文旨在介绍如何使用 PHP 的 json_decode 函数中的 JSON_BIGINT_AS_STRING 标志，优雅地将 JSON 字符串中的大整数转换为字符串，避免在处理嵌套 JSON 时出现双引号转义问题。通过该标志，开发者可以更便捷地处理包含大整数的 JSON 数据，确保数据类型的正确性和一致性。

在处理 JSON 数据时，特别是涉及到大整数时，可能会遇到精度丢失或者需要将大整数转换为字符串的情况。如果使用正则表达式直接替换，可能会导致嵌套 JSON 中的大整数被错误地转义，产生不符合预期的结果。PHP 的 json_decode 函数提供了一个方便的标志 JSON_BIGINT_AS_STRING，可以轻松解决这个问题。

JSON_BIGINT_AS_STRING 的作用

JSON_BIGINT_AS_STRING 是 json_decode 函数的一个标志，当设置了这个标志后，JSON 字符串中所有超过 PHP 整数范围的大整数都会被自动转换为字符串类型。这避免了精度丢失，同时也省去了手动使用正则表达式进行替换的麻烦。

使用示例

假设有如下 JSON 字符串：

{
    "example_bigint": 3330922503411457761,
    "example_json": "{\"example_bigint\": 3330922503411457761}"
}

登录后复制

直接使用 json_decode 解析：

<?php

$jsonString = '{"example_bigint": 3330922503411457761,"example_json": "{\"example_bigint\": 3330922503411457761}"}';

$data = json_decode($jsonString);

print_r($data);

?>

登录后复制

可能导致精度丢失，并且嵌套的 JSON 字符串中的大整数仍然是数字类型。

使用 JSON_BIGINT_AS_STRING 标志解析：

<?php

$jsonString = '{"example_bigint": 3330922503411457761,"example_json": "{\"example_bigint\": 3330922503411457761}"}';

$data = json_decode($jsonString, false, 512, JSON_BIGINT_AS_STRING);

print_r($data);

?>

登录后复制

输出结果：

stdClass Object
(
    [example_bigint] => 3330922503411457761
    [example_json] => {"example_bigint":3330922503411457761}
)

登录后复制

注意：由于 example_json 是一个字符串，其内部的 JSON 并没有被自动解析。如果需要解析 example_json 内部的 JSON，需要再次使用 json_decode 函数，并同样使用 JSON_BIGINT_AS_STRING 标志。

<?php

$jsonString = '{"example_bigint": 3330922503411457761,"example_json": "{\"example_bigint\": 3330922503411457761}"}';

$data = json_decode($jsonString, false, 512, JSON_BIGINT_AS_STRING);

// 解析嵌套的 JSON
$data->example_json = json_decode($data->example_json, false, 512, JSON_BIGINT_AS_STRING);

print_r($data);

?>

登录后复制

输出结果：

stdClass Object
(
    [example_bigint] => 3330922503411457761
    [example_json] => stdClass Object
        (
            [example_bigint] => 3330922503411457761
        )

)

登录后复制

注意事项