im0rtality/jsonstreamingparser

A streaming parser for JSON in PHP.

Installs: 3 715

Dependents: 0

Watchers: 1

Forks: 24

Language: PHP

v4.0.0 2014-07-04 14:50 UTC

README

Build Status

Code forked from https://github.com/salsify/jsonstreamingparser and some fixed added:

  • Removed file_position callback from listener (we did not need it and it gave significant performance boost)
  • PSR2

Features

  • Stream based - low memory footprint does not grow with file size
  • Similar to SAX parser

Known drawbacks

  • Performance is not as good as it should be (throughput - ~1MB per 9 secs, VirtualBox, Debian 7 on 4.3GHz CPU, single core)

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 Parser($stream, $listener);
  $parser->parse();
} catch (Exception $e) {
  fclose($stream);
  throw $e;
}

That's it! Your Listener will receive events from the streaming parser as it works.

License

MIT License