php-parser

Parse PHP code from NodeJS and convert it to AST. This library is a standalone module of a larger project named Glayzzle.

Install it

$ npm install php-parser --save

Try it

$ cd bin
$ node test.js -e "echo 'Hello World';"

Will output :

*** START TESTING ***

-- TOKENS :
T_ECHO T_CONSTANT_ENCAPSED_STRING ;
-- AST :
[ 'program',
  [ [ 'sys',
      'echo',
      [ [ 'string', '"Hello World"' ] ] ] ] ]

Try it online (demo) : https://tonicdev.com/ichiriac/php-parser

Use it

var parser = require('php-parser');
var AST = parser.parseEval('echo "Hello World";');
console.log(AST);

Join the dev

If you want to change/fix the lexer you will find code to ./src/lexer/. Do not change dirrectly ./src/lexer.js or ./src/tokens.js, they are generated with the command npm run build

You can also implement the parser, the code is into ./src/parser/. To check your changes add tests into ./test/parser/, and run npm run test. Try to keep or improve the coverage levels.

The command line options :

Usage: test [options] [-f] <file>

  -f <file>                      Parse and test the specified file
  -d <path>                      Parse each file in the specified path
  -r                             Use recursivity with the specified path
  -e                             Eval the specified input and shows AST
  -v                             Enable verbose mode and show debug
  -h, --help                     Print help and exit

If you run into problems with a test, run it with the cli and add the --debug flag.

Releases

Current version is under developpement, but consider that the lexer sucessfully pass the parsing of ZF2, Laravel, Symfony, and many aspects of php5 and php7 are implemented.

• 0.0.10 : bugfixes and php7 implementation
• 0.0.9 : const (value as expr) bugfix
• 0.0.8 : all tokens are passed on ZF2 (many fixes)
• 0.0.7 : isset, unset, try, catch, finally, fix T_STATIC, fix T_NEW with a dynamic var name, improve tests
• 0.0.6 : Improve tests, implements arrays & new statements
• 0.0.5 : Implement traits

Misc

This library is released under BSD-3 license clause.