php-parser/grammar
nikic db3181aff1 More test coverage and doc string parsing fixes
The parser didn't account for the additional newline after the content of doc strings, which is left there by the tokenizer for some reason. Additoinally esacape sequences were parsed in nowdoc strings.

Additionally this contains some minor changes to the grammar: Some _list nonterminals were refactored to have the possible single elements in a reparate rule and only assemble those single elements. (This reduces duplication and gives better assignment of line number context.)
2011-12-04 16:52:43 +01:00
..
analyze.php Remove node analysis from analyze.php and fix some other things about it 2011-08-14 15:52:57 +02:00
kmyacc.php.parser Cover errors (and fix errors for namespace names) 2011-11-27 12:58:20 +01:00
README.md Do not distribute debug parser anymore 2011-11-27 21:48:34 +01:00
rebuildParser.php More test coverage and doc string parsing fixes 2011-12-04 16:52:43 +01:00
zend_language_parser.phpy More test coverage and doc string parsing fixes 2011-12-04 16:52:43 +01:00

What do all those files mean?

  • zend_language_parser.y: Original PHP grammer this parser is based on
  • zend_language_parser.phpy: PHP grammer written in a pseudo language
  • analyze.php: Analyzes the .phpy-grammer and outputs some info about it
  • rebuildParser.php: Preprocesses the .phpy-grammar and builds the parser using kmyacc
  • kmyacc.php.parser: A kmyacc parser prototype file for PHP

.phpy pseudo language

The .phpy file is a normal grammer in kmyacc (yacc) style, with some transformations applied to it:

  • Nodes are created using the syntax Name[..., ...]. This is transformed into new PHPParser_Node_Name(..., ..., $line, $docComment)
  • Name::abc is transformed to PHPParser_Node_Name::abc
  • Some function-like constructs are resolved (see rebuildParser.php for a list)
  • Associative arrays are written as [key: value, ...], which is transformed to array('key' => value, ...)

Building the parser

In order to rebuild the parser, you need moriyoshi's fork of kmyacc. After you compiled/installed it, run the rebuildParser.php file.

By default only the Parser.php is built. If you want to build the Parser/Debug.php and the y.output file you need to call the file with the debug option: rebuildParser.php?debug.