• 技术文章 >后端开发 >php教程

    PHP8.3要有新函数了!(json_validate函数说明)

    藏色散人藏色散人2023-01-12 10:11:05转载186

    本篇文章给大家带来了关于php8.3的最新相关信息,其中主要介绍了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 相似的接口。

    推荐学习:《PHP视频教程

    以上就是PHP8.3要有新函数了!(json_validate函数说明)的详细内容,更多请关注php中文网其它相关文章!

    声明:本文转载于:learnku,如有侵犯,请联系admin@php.cn删除
    专题推荐:json_validate PHP8.3
    上一篇:PHP原生类的总结分享 下一篇:自己动手写 PHP MVC 框架(40节精讲/巨细/新人进阶必看)

    相关文章推荐

    • 小白怎么快速安装php8.1(附图文)• 图文详解apache2.4+php8.0的安装配置方法• PHP8.2发布了,快来看看有什么改动!• 2023,正式进入 PHP8 普及元年!
    1/1

    PHP中文网