salsify / json-streaming-parser
A streaming parser for JSON in PHP.
Installs: 4 865 766
Dependents: 15
Suggesters: 3
Security: 0
Stars: 745
Watchers: 61
Forks: 131
Open Issues: 8
Requires
- php: >=7.1
- ext-ctype: *
- ext-mbstring: *
Requires (Dev)
- ext-json: *
- phpunit/phpunit: ~9.6
README
This is a simple, streaming parser for processing large JSON documents. Use it for parsing very large JSON documents to avoid loading the entire thing into memory, which is how just about every other JSON parser for PHP works.
For more details, I've written up a longer explanation of the JSON streaming parser that talks about pros and cons vs. the standard PHP JSON parser.
If you've ever used a SAX parser for XML (or even JSON) in another language, that's what this is. Except for JSON in PHP.
This package is compliant with PSR-4, PSR-1, and PSR-2. If you notice compliance oversights, please send a patch via pull request.
Installation
To install JsonStreamingParser
you can either clone this repository or you can use composer
composer require salsify/json-streaming-parser
Usage
To use the JsonStreamingParser
you just have to implement the \JsonStreamingParser\Listener
interface.
You then pass your Listener
into the parser.
For example:
$stream = fopen('doc.json', 'r'); $listener = new YourListener(); try { $parser = new \JsonStreamingParser\Parser($stream, $listener); $parser->parse(); fclose($stream); } catch (Exception $e) { fclose($stream); throw $e; }
That's it! Your Listener
will receive events from the streaming parser as it works.
There is a complete example of this in example/example.php
.
Running tests
make test
Projects using this library
License
MIT License (c) Salsify, Inc.