PHP JSON解析器 - 从任何来源以内存效率高的方式读取大的JSON

php  /  管理员 发布于 1年前   284

JSON Parser是一个零依赖的拉动式解析器，可以从任何源以内存效率高的方式读取大的JSON。

你可以从任何来源读取JSON，如字符串、URL等，并像这样遍历它：

// a source is anything that can provide a JSON, in this case an endpoint
$source = 'https://randomuser.me/api/1.4?seed=json-parser&results=5';
 
foreach (new JsonParser($source) as $key => $value) {
    // instead of loading the whole JSON, we keep in memory only one key and value at a time
}

如果您不想使用foreach，该解析器还提供了一个遍历方法，如下所示：

JsonParser::parse($source)->traverse(function (mixed $value, string|int $key, JsonParser $parser) {
    // lazily load one key and value at a time; we can also access the parser if needed
});

上述示例演示了使用URL处理JSON，但该软件包支持多种数据源。

在撰写本文时，readme列出了以下数据源：

字符串，例如{"foo": "bar"}。

可迭代数组，即数组或Traversable实例

文件路径，例如/path/to/large.json

资源，例如流

API端点URL，例如https://endpoint.json 或Psr\Http\Message\UriInterface 的任何实例

PSR-7请求，即Psr\Http\Message\RequestInterface 的任何实例

PSR-7消息，即Psr\Http\Message\MessageInterface 的任何实例

PSR-7流，即Psr\Http\Message\StreamInterface 的任意实例

Laravel HTTP客户端请求，即Illuminate\Http\Client\Request 的任意实例

Laravel HTTP客户端响应，即任何Illuminate\Http\Client\Response 实例

用户自定义源，即Cerbero/JsonParser/Sources/Source的任何实例

我想指出的是，该库的另一个惊人的功能是指针，

这对于从一个大型JSON数据集中只提取特定的子树非常有用：

// Select the first gender result
$json = JsonParser::parse($source)->pointer('/results/0/gender');
 
foreach ($json as $key => $value) {
    // 1st and only iteration: $key === 'gender', $value === 'female'
}
 
// Get all gender results
$json = JsonParser::parse($source)->pointer('/results/-/gender');
// ...

这个软件包还有许多其他功能我还需要提及，您应该查看一下！

例如，它有一个进度API来跟踪解析进度（即完成百分比、处理字节数等）。

查看这个软件包，获取完整的安装说明，并在GitHub上查看源代码

https://github.com/cerbero90/json-parser