PHP Conference Japan 2024

    预定义常量

    以下常量由此扩展定义，只有在将扩展编译到 PHP 中或在运行时动态加载时才可用。

    以下常量指示 json_last_error() 返回的错误类型或存储为 JsonException 的 code。

    JSON_ERROR_NONE (int)
    没有发生错误。
    JSON_ERROR_DEPTH (int)
    已超过最大堆栈深度。
    JSON_ERROR_STATE_MISMATCH (int)
    发生下溢或模式不匹配。
    JSON_ERROR_CTRL_CHAR (int)
    控制字符错误，可能编码错误。
    JSON_ERROR_SYNTAX (int)
    语法错误。
    JSON_ERROR_UTF8 (int)
    UTF-8 字符格式错误，可能编码错误。
    JSON_ERROR_RECURSION (int)
    传递给 json_encode() 的对象或数组包含递归引用，无法编码。如果给出了 JSON_PARTIAL_OUTPUT_ON_ERROR 选项，则将在递归引用的位置编码 null。
    JSON_ERROR_INF_OR_NAN (int)
    传递给 json_encode() 的值包含 NAN 或 INF。如果给出了 JSON_PARTIAL_OUTPUT_ON_ERROR 选项，则将 0 编码在这些特殊数字的位置。
    JSON_ERROR_UNSUPPORTED_TYPE (int)
    为 json_encode() 提供了不支持类型的值，例如 资源。如果给出了 JSON_PARTIAL_OUTPUT_ON_ERROR 选项，则将在不支持的值的位置编码 null。
    JSON_ERROR_INVALID_PROPERTY_NAME (int)
    在将 JSON 对象解码为 PHP 对象时，传递给 json_decode() 的字符串中存在以 \u0000 字符开头的键。
    JSON_ERROR_UTF16 (int)
    传递给 json_decode() 的 JSON 字符串中包含单个未配对的 UTF-16 代理。

    以下常量可以组合起来，为 json_decode() 形成选项。

    JSON_BIGINT_AS_STRING (int)
    将大整数解码为其原始字符串值。
    JSON_OBJECT_AS_ARRAY (int)
    将 JSON 对象解码为 PHP 数组。可以通过将第二个参数设置为 true 来调用 json_decode() 自动添加此选项。

    以下常量可以组合起来，为 json_encode() 形成选项。

    JSON_HEX_TAG (int)
    所有 < 和 > 都将转换为 \u003C 和 \u003E。
    JSON_HEX_AMP (int)
    所有 & 都将转换为 \u0026。
    JSON_HEX_APOS (int)
    所有 ' 都将转换为 \u0027。
    JSON_HEX_QUOT (int)
    所有 " 都将转换为 \u0022。
    JSON_FORCE_OBJECT (int)
    当使用非关联数组时，输出对象而不是数组。当输出的接收者期望一个对象并且数组为空时，尤其有用。
    JSON_NUMERIC_CHECK (int)
    将数字字符串编码为数字。
    JSON_PRETTY_PRINT (int)
    在返回的数据中使用空格进行格式化。
    JSON_UNESCAPED_SLASHES (int)
    不要转义 /。
    JSON_UNESCAPED_UNICODE (int)
    按字面意思编码多字节 Unicode 字符（默认为转义为 \uXXXX）。
    JSON_PARTIAL_OUTPUT_ON_ERROR (int)
    替换一些无法编码的值，而不是失败。
    JSON_PRESERVE_ZERO_FRACTION (int)
    确保 float 值始终编码为 float 值。
    JSON_UNESCAPED_LINE_TERMINATORS (int)
    当提供 JSON_UNESCAPED_UNICODE 时，换行符保持不转义。它使用与 PHP 7.1 之前没有此常量时相同的行为。从 PHP 7.1.0 开始可用。

    以下常量可以组合起来，为 json_decode() 和 json_encode() 形成选项。

    JSON_INVALID_UTF8_IGNORE (int)
    忽略无效的 UTF-8 字符。从 PHP 7.2.0 开始可用。
    JSON_INVALID_UTF8_SUBSTITUTE (int)
    将无效的 UTF-8 字符转换为 \0xfffd（Unicode 字符“替换字符”）。从 PHP 7.2.0 开始可用。
    JSON_THROW_ON_ERROR (int)
    如果发生错误，则抛出 JsonException，而不是设置使用 json_last_error() 和 json_last_error_msg() 检索的全局错误状态。JSON_PARTIAL_OUTPUT_ON_ERROR 优先于 JSON_THROW_ON_ERROR。从 PHP 7.3.0 开始可用。
    JSON_ERROR_NON_BACKED_ENUM (int)
    传递给 json_encode() 的值包含无法序列化的非支持枚举。从 PHP 8.1.0 开始可用。

    发现问题？

    了解如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加注释

    用户贡献的注释 6 条注释

    91
    majid4466 at gmail dot com
    8 年前
    要获得真正干净的 JSON 字符串，请按如下所示使用这三个常量

    <?php
    $array     = ['€', 'http://example.com/some/cool/page', '337'];
    $bad = json_encode($array);
    $good = json_encode($array, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_NUMERIC_CHECK);

    // $bad 将是 ["\u20ac","http:\/\/example.com\/some\/cool\/page","337"]
    // $good 将是 ["€","http://example.com/some/cool/page",337]
    ?>
    67
    Yzmir Ramirez
    10年前
    如果您好奇这些常量的数值，截至 JSON 1.2.1，这些常量具有以下值（注意您不应该直接使用这些数字）

    JSON_HEX_TAG => 1
    JSON_HEX_AMP => 2
    JSON_HEX_APOS => 4
    JSON_HEX_QUOT => 8
    JSON_FORCE_OBJECT => 16
    JSON_NUMERIC_CHECK => 32
    JSON_UNESCAPED_SLASHES => 64
    JSON_PRETTY_PRINT => 128
    JSON_UNESCAPED_UNICODE => 256

    JSON_ERROR_DEPTH => 1
    JSON_ERROR_STATE_MISMATCH => 2
    JSON_ERROR_CTRL_CHAR => 3

    JSON_ERROR_SYNTAX => 4

    JSON_ERROR_UTF8 => 5
    JSON_OBJECT_AS_ARRAY => 1

    JSON_BIGINT_AS_STRING => 2
    28
    nikospapoutsis
    2年前
    使用 [email protected] 提供的代码或 JSON_NUMERIC_CHECK 时，请**极其谨慎**。

    例如，在精度为 14 且 serialize_precision 为 -1 的 php 7.4 和 8.1 中，我们得到

    <?php
    $array     = ['€', 55.6666666666666666, 'http://example.com/some/cool/page', '000337', '55.6666666666666666'];
    echo     $case1 = json_encode($array);
    echo     $case2 = json_encode($array, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES );
    echo     $case3 = json_encode($array, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_NUMERIC_CHECK);

    [    "\u20ac",55.666666666666664,"http:\/\/example.com\/some\/cool\/page","000337","55.6666666666666666"]
    // 在 $case1 中，欧元符号和 URL 都发生了变化，但我们还在未加引号的浮点数中丢失了一位数字（由于精度）

    ["€",55.666666666666664,"http://example.com/some/cool/page","000337","55.6666666666666666"]
    // 在 $case2 中，欧元符号和 URL 保持完全相同，但我们仍在未加引号的浮点数中丢失了一位数字（由于精度）

    ["€",55.666666666666664,"http://example.com/some/cool/page",337,55.666666666666664]
    // 在 $case3 中，我们再次保持欧元符号和 URL 不变，但这次不仅未加引号的浮点数丢失了一位数字
    // 加引号的浮点数也发生了同样的情况，数字/字符串也丢失了前导零

    另外，请注意，在 php 5.x 中，您可能会得到一些不同但同样错误的结果，因为默认值可能不同，并且某些函数的内部实现也发生了变化。
    17
    [email protected]
    6年前
    在多层数组中，JSON_FORCE_OBJECT 将把所有嵌套的数字数组编码为对象。

    如果您只关心第一层数组（例如，使其适合作为 MySQL JSON 列），您可以将第一层数组强制转换为对象，例如：

    <?php
    $json     = json_encode( (object) $array, JSON_PRESERVE_ZERO_FRACTION+JSON_UNESCAPED_UNICODE );
    ?>

    或者，如果您有大型数组并且担心对象转换的开销，您可以追加一个超出数组大小的“null”值，这将强制数组变为关联数组

    <?php
    $beyond     = count( $array ) + 1;
    if ( !    array_key_exists( $beyond, $array) )
    $array[ $beyond ] = NULL;
    $json = json_encode( $array, JSON_PRESERVE_ZERO_FRACTION+JSON_UNESCAPED_UNICODE );
    ?>

    当然，如果您的后续代码迭代数组，则必须将具有“NULL”值的元素视为与“!isset()”相同。
    0
    [email protected]
    2个月前
    关于 JSON_NUMERIC_CHECK 和科学计数法的警告。

    JSON_NUMERIC_CHECK 将删除科学计数法。因此，
    json_encode(['scientificNumber' => '1e-4'], JSON_NUMERIC_CHECK);
    将返回 {"scientificNumber":0.0001}

    您必须考虑到这一点，因为它可能会破坏科学计数法的全部目的。
    -4
    匿名用户
    6年前
    标志 JSON_NUMERIC_CHECK 和 JSON_PRESERVE_ZERO_FRACTION 在 php 7+ 中已损坏 — json_encode((float)8.8) 返回 "8.8000000000000007"，而 json_encode((float)8.8, JSON_NUMERIC_CHECK) 和 json_encode((float)8.8, JSON_PRESERVE_ZERO_FRACTION) 也返回 "8.8000000000000007"。

    解决此问题的唯一方法是在 php.ini 中设置 "serialize_precision = -1"
    ＋添加注释
    To Top