PHP 7.3 为 json_encode() 和 json_decode() 函数增加的一个新特性使其更好的处理错误。这个特性「 RFC 」以 23 比 0 的投票结果被一致接受。让我们看一看在 PHP 7.2 及一下版本中是如何处理 JSON 错误的，以及 PHP 7.3 中新的改进。
背景
当前在 PHP7.2 版本中，如果要确定 JSON 是否无效，则必须使用 json_last_error() 函数来验证:
>>> json_decode("{");
=> null
>>> json_last_error();
=> 4
>>> json_last_error() === JSON_ERROR_NONE
=> false
>>> json_last_error_msg()
=> "Syntax error"
举个栗子，在 Laravel 中使用 Illuminate\Encryption\Encrypter 类检查以及确保调用 json_encode() 不会导致出错。
// 当我们获取到加密的数值时，我们会先用 base64_encode 处理
// 并且为我们要加密的数值创建用来验证的 MAC 值
// 最后我们会将三者组成的数组 JSON 格式化
$json = json_encode(compact('iv', 'value', 'mac'));
if (json_last_error() !== JSON_ERROR_NONE) {
throw new EncryptException('Could not encrypt the data.');
}
return base64_encode($json);
我们至少可以确定 JSON 编码/解码是否有错，但与抛出异常相比，它有点笨拙，它将错误代码和消息整齐的打包在一块。
虽然我们必须选择使用它，但是在 v7.3 版本中有一个很好的方法让你捕获和处理 JSON 异常——接下来让我们看看我们可以使用的新特性( flag 字面来翻就是标志、旗帜这些，但是此处感觉特性比较好，才疏学浅，请指正)。
PHP 7.3 中的抛出错误的特性
新的特性选项 JSON_THROW_ON_ERROR 可以使用 try/catch 重写此代码块，大约类似于如下内容:
use JsonException;
try {
$json = json_encode(compact('iv', 'value', 'mac'), JSON_THROW_ON_ERROR);
return base64_encode($json);
} catch (JsonException $e) {
throw new EncryptException('Could not encrypt the data.', 0, $e);
}
我想当你收到一些 JSON 数据而不用去深究和 json_last_error() 匹配的标志时，这种风格对的 userland 代码特别有用，这样 JSON 编码和解码可以更加高效的去处理错误
PHP 7.3 中 json_decode 函数增加了一些参数，用来处理错误，比如如下所示:
use JsonException;
try {
return json_decode($jsonString, $assoc = true, $depth = 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
// 处理 JSON 异常
}
// Or even just let it bubble up...
/**
* 将 JSON 字符串解码为数组 (Decode a JSON string into an array)
*
* @return array
* @throws JsonException
*/
function decode($jsonString) {
return json_decode($jsonString, $assoc = true, $depth = 512, JSON_THROW_ON_ERROR);
}
获取错误代码和错误信息
以前你想查看 JSON 的错误代码和错误信息，需要使用以下函数：
// 错误代码
json_last_error();
// 易于理解的错误信息
json_last_error_msg();
如果你使用新的「JSON_THROW_ON_ERROR」参数，获取错误代码和错误信息的方式如下：
try {
return json_decode($jsonString, $assoc = true, $depth = 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
$e->getMessage(); // like json_last_error_msg()
$e->getCode(); // like json_last_error()
}
查看更多 API 详细信息，请访问「base Exception 」， JsonException 异常是 Exception 的一个子类。
JSON 在 PHP 7.3 中的默认行为
当升级到 PHP 7.3 时，你将在一天内完成代码的向后兼容，并按照预期的结果继续工作。
PHP 的默认函数 json_encode|decode() 的行为没有改变， 在抛出的错误中 RFC 增加了一个新的选项和异常类。
了解更多
本文中的所有译文仅用于学习和交流目的，转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议，如果我们的工作有侵犯到您的权益，请及时联系我们。
