PHP8.3 akan mempunyai fungsi baharu! (json_validate perihalan fungsi)

Artikel ini membawakan anda maklumat terkini yang berkaitan tentang php8.3 Ia terutamanya memperkenalkan bahawa PHP8.3 akan menambah fungsi yang dipanggil json_validate. Jadi apakah kegunaan fungsi ini? Bagaimana cara menggunakannya? Mari kita lihat bersama-sama, saya harap ia akan membantu semua orang.

Pratonton PHP 8.3: fungsi `json_validate`

PHP 8.3 akan menambah fungsi bernama json_validate untuk mengesahkan yang diluluskan Sama ada input rentetan ialah rentetan JSON yang sah.

Pada masa ini, cara biasa untuk mengesahkan rentetan JSON ialah cuba menyahkodnya dan menangkap pengecualian untuk menentukannya. Tetapi dalam beberapa kes, kami mungkin tidak perlu mendapatkan kandungan tertentu, tetapi hanya perlu mengesahkan bahawa ia adalah sah. Fungsi json_validate baharu menggunakan kurang memori dan sumber berbanding json_decode kerana ia hanya menghuraikan rentetan tanpa cuba menyahkodnya.

Tandatangan fungsi

/**
 * 验证传入的字符串是否为合法 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 {}

Bendera

Parameter ketiga json_validate ialah bendera, digunakan untuk menentukan tingkah laku fungsi . Pada masa ini, satu-satunya bendera yang tersedia ialah JSON_INVALID_UTF8_IGNORE.

Bendera ini telah ditambahkan dalam PHP 7.2 sebagai pemalar bendera json_decode untuk mengabaikan aksara UTF-8 dalam rentetan yang sepadan.

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

Ralat pengendalian

json_validate sendiri tidak mengembalikan kod ralat Jika anda ingin mendapatkan maklumat ralat tertentu, anda boleh menggunakan json_last_error dan json_last_error_msg untuk mendapatkannya. .

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"

Contoh

Sahkan pengecualian rentetan dan lempar

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

Gantikan kaedah pengesahan sebelumnya

- $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']);

Penyesuaian awal Polyfill

Jika anda ingin menyesuaikan diri dengan PHP 8.3 terlebih dahulu, anda boleh melakukannya selepas keluaran 8.3 Untuk suis lancar kepada json_validate, anda boleh mentakrifkan fungsi secara manual untuk meniru tingkah laku json_validate dalam versi sebelumnya.

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(&#39;json_validate(): Argument #2 ($depth) must be greater than 0&#39;);  
  }  
  \json_decode($json, null, $depth, $flags);  
  return \json_last_error() === \JSON_ERROR_NONE;  
  }  
}

Memandangkan fungsi ini masih menggunakan json_decode secara dalaman, sebenarnya tiada peningkatan prestasi, tetapi ia hanya menyediakan antara muka yang serupa dengan json_validate.

Pembelajaran yang disyorkan: "Tutorial Video PHP"

Atas ialah kandungan terperinci PHP8.3 akan mempunyai fungsi baharu! (json_validate perihalan fungsi). Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!