PHP解析JSON错误处理技巧

golang学习网今天将给大家带来《PHP解析JSON错误捕获方法》，感兴趣的朋友请继续看下去吧！以下内容将会涉及到等等知识点，如果你是正在学习文章或者已经是大佬级别了，都非常欢迎也希望大家都能给我建议评论哈~希望能帮助到大家！

使用json_last_error()和JSON_THROW_ON_ERROR可检测JSON解析错误，结合封装函数返回友好提示，提升调试效率。

PHP 中使用 json_decode() 解析 JSON 字符串时，如果内容存在语法错误（如引号不匹配、非法字符、格式错误等），函数不会抛出异常，而是返回 null。因此需要额外手段来检测和捕获这些错误。通过结合错误标志和封装处理逻辑，可以实现更友好的错误提示。

使用 json_last_error() 检查解析错误

PHP 提供了 json_last_error() 函数，用于获取最后一次 JSON 操作的错误状态。配合 json_decode() 使用，可判断是否解析成功：

示例代码：

function safeJsonDecode($jsonString) {
    $data = json_decode($jsonString, true);
    
    if (json_last_error() === JSON_ERROR_NONE) {
        return ['success' => true, 'data' => $data];
    }

    return [
        'success' => false,
        'error'   => json_last_error_msg(),
        'raw'     => $jsonString
    ];
}

添加 JSON_THROW_ON_ERROR 标志（PHP 7.3+）

从 PHP 7.3 开始，json_decode() 支持传入 JSON_THROW_ON_ERROR 标志，使函数在出错时抛出 JsonException 异常，便于用 try-catch 捕获：

try {
    $data = json_decode($jsonString, true, 512, JSON_THROW_ON_ERROR);
    echo "解析成功";
} catch (JsonException $e) {
    echo "JSON 解析失败: " . $e->getMessage();
}

封装通用解析函数返回友好提示

将上述方法整合，可创建一个健壮的 JSON 解析包装函数，兼顾兼容性和提示清晰度：

function parseJson($jsonString) {
    // 去除 BOM 或空白字符干扰
    $jsonString = trim($jsonString);
    if (substr($jsonString, 0, 3) === pack("CCC", 0xEF, 0xBB, 0xBF)) {
        $jsonString = substr($jsonString, 3);
    }

    if (PHP_VERSION_ID >= 70300) {
        try {
            $data = json_decode($jsonString, true, 512, JSON_THROW_ON_ERROR);
            return ['success' => true, 'data' => $data];
        } catch (JsonException $e) {
            return [
                'success' => false,
                'error'   => $e->getMessage(),
                'code'    => $e->getCode()
            ];
        }
    } else {
        $data = json_decode($jsonString, true);
        if (json_last_error() === JSON_ERROR_NONE) {
            return ['success' => true, 'data' => $data];
        }
        return [
            'success' => false,
            'error'   => json_last_error_msg(),
            'hint'    => '请检查 JSON 格式，如引号、逗号、括号是否正确'
        ];
    }
}

调用示例：

$result = parseJson('{"name": "张三", "age": }');
if (!$result['success']) {
    echo "错误提示：" . $result['error'];
}

基本上就这些。合理使用错误检测机制和异常处理，能让 JSON 解析更可靠，调试更高效。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。