composer/iTop

mirror of https://github.com/Combodo/iTop.git synced 2026-04-28 04:58:46 +02:00

Files

Pierre Goiffon a7e7e62245 ⬆️ Upgrade lib : nikic/php-parser

We were on v3 that is no longer maintained and compatibility is annonced for PHP 7.2.
v4 is active and supports PHP up to 8.0
No problem to update as this is only used in the config editor (\Combodo\iTop\Config\Validator\iTopConfigAstValidator)

2021-03-29 16:35:30 +02:00

1.4 KiB

Raw Blame History

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 grammar 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

Run php grammar/rebuildParsers.php to rebuild the parsers. Additional options:

The KMYACC environment variable can be used to specify an alternative kmyacc binary. By default the phpyacc dev dependency will be used. To use the original kmyacc, you need to compile moriyoshi's fork.
The --debug option enables emission of debug symbols and creates the y.output file.
The --keep-tmp-grammar option preserves the preprocessed grammar file.