json_validate

(PHP 8 >= 8.3.0)

json_validate检查一个字符串是否包含有效的JSON

说明

json_validate(string $json, int $depth = 512, int $flags = 0): bool

返回给定的 string 是否是语法上有效的 JSON。 如果 json_validate() 返回 truejson_decode() 在使用相同的 depthflags 时,将成功解码给定的字符串。

如果 json_validate() 返回 false,原因可以使用 json_last_error()json_last_error_msg() 获取。

如果解码后的 JSON 内容未被使用,json_validate() 相比于 json_decode() 使用了较少的内存,因为它不需要构建包含有效载荷的数组或对象结构。

警告

json_decode() 之前调用 json_validate() 将不必要地解析字符串两次, 因为 json_decode() 在解码过程中隐式地执行验证。

json_validate() 只有在解码后的 JSON 内容不会立即使用,但需要知道字符串是否包含有效的 JSON 时才有用。

参数

json

需要验证的字符串。

该函数仅适用于 UTF-8 编码字符串。

注意:

PHP 实现了 JSON 的一个超集,参考 » RFC 7159.

depth

解码结构的最大嵌套深度。 该值必须大于 0、 且小于或等于 2147483647

flags

当前只接受 JSON_INVALID_UTF8_IGNORE

返回值

如果给定字符串是语法有效的 JSON,则返回 true,否则返回 false

错误/异常

如果 depth 超出允许的范围,将抛出 ValueError

如果 flags 不是一个有效的 flag,将抛出 ValueError

示例

示例 #1 json_validate() 示例

<?php
var_dump
(json_validate('{ "test": { "foo": "bar" } }'));
var_dump(json_validate('{ "": "": "" } }'));
?>

以上示例会输出:

bool(true)
bool(false)

参见

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top