PHP8.3的json_validate函數怎么使用

本文小編為大家詳細介紹“PHP8.3的json_validate函數怎么使用”，內容詳細，步驟清晰，細節處理妥當，希望這篇“PHP8.3的json_validate函數怎么使用”文章能幫助大家解決疑惑，下面跟著小編的思路慢慢深入，一起來學習新知識吧。

PHP 8.3 前瞻：`json_validate` 函數

PHP 8.3 將會添加名為 json_validate 的函數，用于驗證傳入的字符串是否是合法的 JSON 字符串。

在目前，驗證 JSON 字符串的一種通用做法是嘗試將其解碼，并通過捕獲異常來確定。但某些情況下我們可能并不需要獲得具體的內容，只需要驗證其合法。新的 json_validate 函數相比 json_decode 耗用的內存和資源更少，因為它只分析字符串而不會嘗試解碼。

函數簽名

/**
 * 驗證傳入的字符串是否為合法 JSON 字符串
 *
 * @param string $json 準備驗證的字符串
 * @param int $depth 最大嵌套深度，必須大于 0
 * @param int $flags 標志掩碼，用于指定行為
 * @return bool $json 是合法 JSON 字符串時返回 true，否則返回 false
 */
function json_validate(string $json, int $depth = 512, int $flags = 0): bool {}

標志 Flags

json_validate 的第三個參數是 flags，用于指定函數的行為。在目前，唯一可用的標志是 JSON_INVALID_UTF8_IGNORE。

該標志在 PHP 7.2 中添加，作為 json_decode 的標志常量，用于忽略對應字符串中的 UTF-8 字符。

json_validate('[1, 2, 3]', flags: JSON_INVALID_UTF8_IGNORE); // true

json_validate("[\"\xc1\xc1\",\"a\"]"); // false
json_validate("[\"\xc1\xc1\",\"a\"]", flags: JSON_INVALID_UTF8_IGNORE); // true

錯誤處理

json_validate 本身并不會返回錯誤碼，如果你想要獲取具體的錯誤信息，可用使用 json_last_error 和 json_last_error_msg 獲取。

json_validate(""); // false

json_last_error(); // 4
json_last_error_msg(); // "Syntax error"

json_validate("null"); // true

json_last_error(); // 0
json_last_error_msg(); // "No error"

示例

驗證字符串并拋出異常

if (json_validate($_GET['json']) === false) {
    throw new \JsonException(json_last_error_msg(), json_last_error());
}

替代以前的驗證方式

- $value = json_decode($_GET['json'], flags: JSON_THROW_ON_ERROR);
+ if (!json_validate($_GET['json'])) {
+   throw new \JsonException(json_last_error_msg(), json_last_error());
+ }
+ $value = json_decode($_GET['json']);

Polyfill 搶先適配

如果你想提前為 PHP 8.3 做適配，以在 8.3 發布的第一時間無縫切換到 json_validate，你可以手動定義一個函數，以在之前的版本中模仿 json_validate 的作用。

if (!function_exists('json_validate')) {  
  function json_validate(string $json, int $depth = 512, int $flags = 0): bool {  
  if ($flags !== 0 && $flags !== \JSON_INVALID_UTF8_IGNORE) {  
  throw new \ValueError('json_validate(): Argument #3 ($flags) must be a valid flag (allowed flags: JSON_INVALID_UTF8_IGNORE)');  
  }  
  if ($depth <= 0 ) {  
  throw new \ValueError('json_validate(): Argument #2 ($depth) must be greater than 0');  
  }  
  \json_decode($json, null, $depth, $flags);  
  return \json_last_error() === \JSON_ERROR_NONE;  
  }  
}

由于此函數內部依然使用 json_decode，所以其實際上并沒有性能上的改進，只是提供了和 json_validate 相似的接口。

讀到這里，這篇“PHP8.3的json_validate函數怎么使用”文章已經介紹完畢，想要掌握這篇文章的知識點還需要大家自己動手實踐使用過才能領會，如果想了解更多相關內容的文章，歡迎關注億速云行業資訊頻道。