php如何捕获解析json语法错误_phpjson_decode加标志与异常包装返回提示

絕刀狂花
发布: 2025-11-26 19:48:08
原创
707人浏览过
使用json_last_error()和JSON_THROW_ON_ERROR可检测JSON解析错误,结合封装函数返回友好提示,提升调试效率。

php如何捕获解析json语法错误_phpjson_decode加标志与异常包装返回提示

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

使用 json_last_error() 检查解析错误

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

  • JSON_ERROR_NONE:无错误
  • JSON_ERROR_DEPTH:超过最大堆深度
  • JSON_ERROR_STATE_MISMATCH:语法错误,如括号不匹配
  • JSON_ERROR_CTRL_CHAR:控制字符错误
  • JSON_ERROR_SYNTAX:语法错误
  • JSON_ERROR_UTF8:UTF-8 编码错误

示例代码:

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 捕获:

立即学习PHP免费学习笔记(深入)”;

PatentPal专利申请写作
PatentPal专利申请写作

AI软件来为专利申请自动生成内容

PatentPal专利申请写作 266
查看详情 PatentPal专利申请写作

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 解析更可靠,调试更高效。

以上就是php如何捕获解析json语法错误_phpjson_decode加标志与异常包装返回提示的详细内容,更多请关注php中文网其它相关文章!

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号