tsufeki/php-lenient-parser

A PHP parser written in PHP, handles partial/illegal input

PHP Lenient Parser

This is a PHP 7 parser written in PHP. It handles some partial and illegal code, producing best-effort partial syntax tree. Its purpose is to simplify static code analysis and manipulation., _(*1)

It's error reporting is not complete though, i.e. it may silently accept illegal PHP input., _(*2)

As this is just a parser replacement for PHP Parser, go there for actual documentation., _(*3)

Installation

The preferred installation method is composer:, _(*4)

php composer.phar require tsufeki/php-lenient-parser

Usage

Use the factory to get an instance of parser:, _(*5)

$parser = (new LenientParserFactory())->create();

Or provide your own lexer and options (no options are supported at the moment though):, _(*6)

$parser = (new LenientParserFactory())->create(LenientParserFactory::ONLY_PHP7, $lexer, $options);

Created parser is a drop-in replacement for php-parser., _(*7)

Do not instantiate LenientParser directly, use the factory., _(*8)

Info

At the moment parsing of PHP 5 is not supported, only PHP 7., _(*9)

Internally, the parser is implemented as a Pratt parser (also called "Top down operator precedence parser")., _(*10)

License

Same as php-parser, BSD - see LICENCE., _(*11)

Test suite and CLI script (below bin/, test/ and test_old/) are borrowed from php-parser and modified., _(*12)