phabel/php-parser
1
0
Fork 0
mirror of https://github.com/phabelio/PHP-Parser.git synced 2024-11-30 04:29:15 +01:00
Code Issues Projects Releases Wiki Activity
caa5c0cc76
php-parser/grammar
History
Nikita Popov caa5c0cc76 Graceful handling for "special" errors 
Nearly all special errors are now handled gracefully, i.e. the
parser will be able to continue after encountering them. In some
cases the associated error range has been improved using the new
end attribute stack.

To achieve this the error handling code has been moved out of the
node constructors and into special methods in the parser.
2016-10-09 12:38:18 +02:00
..
parser.template Move token constants into separate class 2015-06-13 18:39:55 +02:00
php5.y Graceful handling for "special" errors 2016-10-09 12:38:18 +02:00
php7.y Graceful handling for "special" errors 2016-10-09 12:38:18 +02:00
README.md Fix typo in grammar/README.md 2016-08-11 16:17:08 +02:00
rebuildParsers.php Fix GroupUse prefix attribute assignment 2016-10-08 23:55:46 +02:00
tokens.template Move token constants into separate class 2015-06-13 18:39:55 +02:00
tokens.y Implement generalized yield operator 2015-06-13 18:11:40 +02:00

README.md

What do all those files mean?

  • php5.y: PHP 5 grammar written in a pseudo language
  • php7.y: PHP 7 grammar written in a pseudo language
  • tokens.y: Tokens definition shared between PHP 5 and PHP 7 grammars
  • parser.template: A kmyacc parser prototype file for PHP
  • tokens.template: A kmyacc prototype file for the Tokens class
  • rebuildParsers.php: Preprocesses the grammar and builds the parser using kmyacc

.phpy pseudo language

The .y 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 Name(..., ..., attributes())
  • Some function-like constructs are resolved (see rebuildParsers.php for a list)

Building the parser

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

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