1
0
mirror of https://github.com/danog/PHP-Parser.git synced 2025-01-22 13:51:12 +01:00
Nikita Popov 6996db1e3a Build node attributes inside semantic action methods
Minor performance improvement for parsing, also allows to access
attributes with higher granulity in the parser, though this is not
currently done.

* #n can now be used to access the stack position of a token. $n
  is the same as $this->semStack[#n]. (Post-translate $n will
  actually be the stack position.)
* $attributeStack is now $this->startAttributeStack and
  $endAttributes is now $this->endAttributes.
* Attributes for a node are now computed inside the individual
  reduction methods, instead of being passed as a parameter.
  Accessible through the attributes() macro.
2015-04-26 11:55:59 +02:00
..

What do all those files mean?

  • 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 Node\Name(..., ..., $attributes)
  • Name::abc is transformed to 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 script.

By default only the Parser.php is built. If you want to additionally build Parser/Debug.php and y.output run the script with --debug. If you want to retain the preprocessed grammar pass --keep-tmp-grammar.