php的json校验json-schema

客户端和服务端的http信息传递，采用json几乎成了标配。json格式简单，易于处理，不过由于没有格式规定，无法校验。

好在php有json-schema模块，可以用来验证json是否符合规定的格式。

安装使用composer

composer require justinrainbow/json-schema:~1.3

新建一个schema文件，如：schema.json

{
    "type": "object",
    "properties": {
        "firstName": {
            "type": "string",
                         "required": true
        },
        "lastName": {
            "type": "string"
        },
        "age": {

            "type": "integer",
            "minimum": 0
        },
        "data":{
             "type":"object",
             "required":true,
             "properties":{

                }
        }
    }

}        

可以在字段里嵌套子结构，如果properties为空，则可以任意，比如上例的data。

类型有：

array
A JSON array.
boolean
A JSON boolean.
integer
A JSON number without a fraction or exponent part.
number
Any JSON number. Number includes integer.
null
The JSON null value.
object
A JSON object.
string
A JSON string.

php代码如下：

        $json = '{"firstName":"ban", "lastName":"shan","age":1,"data":{"hobby":"coding"} }';
        $validator = new JsonSchema\Validator;
        $schema = file_get_contents("schema.json");
        $validator->check(json_decode($json), json_decode($schema));
        if ($validator->isValid()) {
            echo "The supplied JSON validates against the schema.\n";
        } else {
            echo "JSON does not validate. Violations:\n";
            foreach ($validator->getErrors() as $error) {
                echo sprintf("[%s] %s\n", $error['property'], $error['message']);
            }
        }

这样先定义好通信的schema，在json发送给客户端之前校验是否和约定相同，避免不必要的错误。

参考链接，json-schema文档，php的json-schema实现。

完整的代码在此。