Release PHP-Parser 4.0.3

Store comment at end of class in Nop statement
Fixed #509.
2025-07-16 20:06:32 +02:00 · 2018-07-15 19:25:16 +02:00 · 2018-07-07 12:49:49 +02:00 · 2018-07-07 12:34:07 +02:00 · 2018-07-07 12:25:01 +02:00 · 2018-07-07 12:24:06 +02:00
274 changed files with 5975 additions and 3195 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,84 @@
-Version 4.0.0-dev
+Version 4.0.4-dev
 -----------------

 Nothing yet.

+Version 4.0.3 (2018-07-15)
+--------------------------
+
+### Fixed
+
+* Fixed possible undefined offset notice in formatting-preserving printer. (#513)
+
+### Added
+
+* Improved error recovery inside arrays.
+* Preserve trailing comment inside classes. **Note:** This change is possibly BC breaking if your
+  code validates that classes can only contain certain statement types. After this change, classes
+  can also contain Nop statements, while this was not previously possible. (#509)
+
+Version 4.0.2 (2018-06-03)
+--------------------------
+
+### Added
+
+* Improved error recovery inside classes.
+* Support error recovery for `foreach` without `as`.
+* Support error recovery for parameters without variable (`function (Type ) {}`).
+* Support error recovery for functions without body (`function ($foo)`).
+
+Version 4.0.1 (2018-03-25)
+--------------------------
+
+### Added
+
+* [PHP 7.3] Added support for trailing commas in function calls.
+* [PHP 7.3] Added support for by-reference array destructuring. 
+* Added checks to node traverser to prevent replacing a statement with an expression or vice versa.
+  This should prevent common mistakes in the implementation of node visitors.
+* Added the following methods to `BuilderFactory`, to simplify creation of expressions:
+  * `funcCall()`
+  * `methodCall()`
+  * `staticCall()`
+  * `new()`
+  * `constFetch()`
+  * `classConstFetch()`
+
+Version 4.0.0 (2018-02-28)
+--------------------------
+
+* No significant code changes since the beta 1 release.
+
+Version 4.0.0-beta1 (2018-01-27)
+--------------------------------
+
+### Fixed
+
+* In formatting-preserving pretty printer: Fixed indentation when inserting into lists. (#466)
+
+### Added
+
+* In formatting-preserving pretty printer: Improved formatting of elements inserted into multi-line
+  arrays.
+
+### Removed
+
+* The `Autoloader` class has been removed. It is now required to use the Composer autoloader.
+
+Version 4.0.0-alpha3 (2017-12-26)
+---------------------------------
+
+### Fixed
+
+* In the formatting-preserving pretty printer:
+  * Fixed comment indentation.
+  * Fixed handling of inline HTML in the fallback case.
+  * Fixed insertion into list nodes that require creation of a code block.
+
+### Added
+
+* Added support for inserting at the start of list nodes in formatting-preserving pretty printer.
+
 Version 4.0.0-alpha2 (2017-11-10)
 ---------------------------------

@@ -78,10 +154,28 @@ Version 4.0.0-alpha1 (2017-10-18)
 * The `BuilderAbstract` class has been removed. It's functionality is moved into `BuilderHelpers`.
  However, this is an internal class and should not be used directly.

-Version 3.1.3-dev
-----------------
+Version 3.1.5 (2018-02-28)
+--------------------------

-Nothing yet.
+### Fixed
+
+* Fixed duplicate comment assignment in switch statements. (#469)
+* Improve compatibility with PHP-Scoper. (#477)
+
+Version 3.1.4 (2018-01-25)
+--------------------------
+
+### Fixed
+
+* Fixed pretty printing of `-(-$x)` and `+(+$x)`. (#459)
+
+Version 3.1.3 (2017-12-26)
+--------------------------
+
+### Fixed
+
+* Improve compatibility with php-scoper, by supporting prefixed namespaces in
+  `NodeAbstract::getType()`.

 Version 3.1.2 (2017-11-04)
 --------------------------
@@ -112,7 +206,7 @@ Version 3.1.0 (2017-07-28)
 * [PHP 7.2] Added support for trailing comma in group use statements.
 * [PHP 7.2] Added support for `object` type. This means `object` types will now be represented as a
  builtin type (a simple `"object"` string), rather than a class `Name`.
-  
+
 ### Fixed

 * Floating-point numbers are now printed correctly if the LC_NUMERIC locale uses a comma as decimal
@@ -232,7 +326,7 @@ This release primarily improves our support for error recovery.
  `NameResolver::__construct()`.
 * The `NameResolver` now adds a `namespacedName` attribute on name nodes that cannot be statically
  resolved (unqualified unaliased function or constant names in namespaces).
-  
+
 ### Fixed

 * Fixed attribute assignment for `GroupUse` prefix and variables in interpolated strings.
@@ -476,4 +570,4 @@ A more detailed description of backwards incompatible changes can be found in th

 **This changelog only includes changes from the 2.0 series. For older changes see the
 [1.x series changelog](https://github.com/nikic/PHP-Parser/blob/1.x/CHANGELOG.md) and the
-[0.9 series changelog](https://github.com/nikic/PHP-Parser/blob/0.9/CHANGELOG.md).**
+[0.9 series changelog](https://github.com/nikic/PHP-Parser/blob/0.9/CHANGELOG.md).**
--- a/4
+++ b/4
@@ -1,4 +1,4 @@
-Copyright (c) 2011 by Nikita Popov.
+Copyright (c) 2011-2018 by Nikita Popov.

 Some rights reserved.

@@ -28,4 +28,4 @@ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
--- a/README.md
+++ b/README.md
@@ -6,9 +6,9 @@ PHP Parser
 This is a PHP 5.2 to PHP 7.2 parser written in PHP. Its purpose is to simplify static code analysis and
 manipulation.

-[**Documentation for version 3.x**][doc_3_x] (stable; for running on PHP >= 5.5; for parsing PHP 5.2 to PHP 7.2).
+[**Documentation for version 4.x**][doc_master] (stable; for running on PHP >= 7.0; for parsing PHP 5.2 to PHP 7.2).

-[Documentation for version 4.x][doc_master] (development; for running on PHP >= 7.0; for parsing PHP 5.2 to PHP 7.2).
+[Documentation for version 3.x][doc_3_x] (stable; for running on PHP >= 5.5; for parsing PHP 5.2 to PHP 7.2).

 Features
 --------
@@ -183,12 +183,16 @@ Documentation

 1. [Introduction](doc/0_Introduction.markdown)
 2. [Usage of basic components](doc/2_Usage_of_basic_components.markdown)
- 3. [Other node tree representations](doc/3_Other_node_tree_representations.markdown)
- 4. [Code generation](doc/4_Code_generation.markdown)
- 5. [Frequently asked questions](doc/5_FAQ.markdown)

 Component documentation:

+ * [Walking the AST](doc/component/Walking_the_AST.markdown)
+   * Node visitors
+   * Modifying the AST from a visitor
+   * Short-circuiting traversals
+   * Interleaved visitors
+   * Simple node finding API
+   * Parent and sibling references
 * [Name resolution](doc/component/Name_resolution.markdown)
   * Name resolver options
   * Name resolution context
@@ -196,6 +200,8 @@ Component documentation:
   * Converting AST back to PHP code
   * Customizing formatting
   * Formatting-preserving code transformations
+ * [AST builders](doc/component/AST_builders.markdown)
+   * Fluent builders for AST nodes
 * [Lexer](doc/component/Lexer.markdown)
   * Lexer options
   * Token and file positions for nodes
@@ -203,10 +209,17 @@ Component documentation:
 * [Error handling](doc/component/Error_handling.markdown)
   * Column information for errors
   * Error recovery (parsing of syntactically incorrect code)
+ * [Constant expression evaluation](doc/component/Constant_expression_evaluation.markdown)
+   * Evaluating constant/property/etc initializers
+   * Handling errors and unsupported expressions
+ * [JSON representation](doc/component/JSON_representation.markdown)
+   * JSON encoding and decoding of ASTs
 * [Performance](doc/component/Performance.markdown)
   * Disabling XDebug
   * Reusing objects
   * Garbage collection impact
+ * [Frequently asked questions](doc/component/FAQ.markdown)
+   * Parent and sibling references

 [doc_3_x]: https://github.com/nikic/PHP-Parser/tree/3.x/doc
 [doc_master]: https://github.com/nikic/PHP-Parser/tree/master/doc
--- a/UPGRADE-3.0.md
+++ b/UPGRADE-3.0.md
@@ -4,7 +4,7 @@ Upgrading from PHP-Parser 2.x to 3.0
 The backwards-incompatible changes in this release may be summarized as follows:

 * The specific details of the node representation have changed in some cases, primarily to
-   accomodate new PHP 7.1 features.
+   accommodate new PHP 7.1 features.
 * There have been significant changes to the error recovery implementation. This may affect you,
   if you used the error recovery mode or have a custom lexer implementation.
 * A number of deprecated methods were removed.
--- a/UPGRADE-4.0.md
+++ b/UPGRADE-4.0.md
@@ -6,7 +6,7 @@ Upgrading from PHP-Parser 3.x to 4.0
 PHP-Parser now requires PHP 7.0 or newer to run. It is however still possible to *parse* PHP 5.2-5.6
 source code, while running on a newer version.

-Because HHVM does not support PHP 7, HHVM is no longer supported.
+HHVM is no longer actively supported.

 ### Changes to the node structure

@@ -17,7 +17,7 @@ Because HHVM does not support PHP 7, HHVM is no longer supported.
  comparisons or strict-mode may require adjustment. The following is an exhaustive list of all
  affected subnodes:

-   * `Const::$name`
+   * `Const_::$name`
   * `NullableType::$type` (for simple types)
   * `Param::$type` (for simple types)
   * `Expr\ClassConstFetch::$name`
@@ -29,8 +29,8 @@ Because HHVM does not support PHP 7, HHVM is no longer supported.
   * `Stmt\Class_::$name`
   * `Stmt\ClassMethod::$name`
   * `Stmt\ClassMethod::$returnType` (for simple types)
-   * `Stmt\Function::$name`
-   * `Stmt\Function::$returnType` (for simple types)
+   * `Stmt\Function_::$name`
+   * `Stmt\Function_::$returnType` (for simple types)
   * `Stmt\Goto_::$name`
   * `Stmt\Interface_::$name`
   * `Stmt\Label::$name`
@@ -48,11 +48,11 @@ Because HHVM does not support PHP 7, HHVM is no longer supported.
 * The `name` subnode of `StaticVar` has been renamed to `var` and now contains a `Variable` rather
  than a plain string.
 * The `var` subnode of `ClosureUse` now contains a `Variable` rather than a plain string.
-* The `var` subnode of `Catch` now contains a `Variable` rather than a plain string.
+* The `var` subnode of `Catch_` now contains a `Variable` rather than a plain string.
 * The `alias` subnode of `UseUse` is now `null` if no explicit alias is given. As such,
  `use Foo\Bar` and `use Foo\Bar as Bar` are now represented differently. The `getAlias()` method
  can be used to get the effective alias, even if it is not explicitly given.
-  
+
 ### Miscellaneous

 * The indentation handling in the pretty printer has been changed (this is only relevant if you
@@ -62,7 +62,7 @@ Because HHVM does not support PHP 7, HHVM is no longer supported.

 ### Removed functionality

-* Removed `type` subnode on `Class`, `ClassMethod` and `Property` nodes. Use `flags` instead.
+* Removed `type` subnode on `Class_`, `ClassMethod` and `Property` nodes. Use `flags` instead.
 * The `ClassConst::isStatic()` method has been removed. Constants cannot have a static modifier.
 * The `NodeTraverser` no longer accepts `false` as a return value from a `leaveNode()` method.
  `NodeTraverser::REMOVE_NODE` should be returned instead.
@@ -73,4 +73,5 @@ Because HHVM does not support PHP 7, HHVM is no longer supported.
 * The XML serializer has been removed. As such, the classes `Serializer\XML`, and
  `Unserializer\XML`, as well as the interfaces `Serializer` and `Unserializer` no longer exist.
 * The `BuilderAbstract` class has been removed. It's functionality is moved into `BuilderHelpers`.
-  However, this is an internal class and should not be used directly.
+  However, this is an internal class and should not be used directly.
+* The `Autoloader` class has been removed in favor of relying on the Composer autoloader.
--- a/bin/php-parse
+++ b/bin/php-parse
@@ -81,6 +81,9 @@ foreach ($files as $file) {
        } elseif ('pretty-print' === $operation) {
            echo "==> Pretty print:\n";
            echo $prettyPrinter->prettyPrintFile($stmts), "\n";
+        } elseif ('json-dump' === $operation) {
+            echo "==> JSON dump:\n";
+            echo json_encode($stmts, JSON_PRETTY_PRINT), "\n";
        } elseif ('var-dump' === $operation) {
            echo "==> var_dump():\n";
            var_dump($stmts);
@@ -112,6 +115,7 @@ Operations is a list of the following options (--dump by default):

    -d, --dump              Dump nodes using NodeDumper
    -p, --pretty-print      Pretty print file using PrettyPrinter\Standard
+    -j, --json-dump         Print json_encode() result
        --var-dump          var_dump() nodes (for exact structure)
    -N, --resolve-names     Resolve names using NodeVisitor\NameResolver
    -c, --with-column-info  Show column-numbers for errors (if available)
@@ -155,8 +159,9 @@ function parseArgs($args) {
            case '-p':
                $operations[] = 'pretty-print';
                break;
-            case '--serialize-xml':
-                $operations[] = 'serialize-xml';
+            case '--json-dump':
+            case '-j':
+                $operations[] = 'json-dump';
                break;
            case '--var-dump':
                $operations[] = 'var-dump';
--- a/composer.json
+++ b/composer.json
@@ -14,7 +14,7 @@
        "ext-tokenizer": "*"
    },
    "require-dev": {
-        "phpunit/phpunit": "^6"
+        "phpunit/phpunit": "^6.5 || ^7.0"
    },
    "autoload": {
        "psr-4": {
--- a/doc/0_Introduction.markdown
+++ b/doc/0_Introduction.markdown
@@ -1,7 +1,7 @@
 Introduction
 ============

-This project is a PHP 5.2 to PHP 7.1 parser **written in PHP itself**.
+This project is a PHP 5.2 to PHP 7.2 parser **written in PHP itself**.

 What is this for?
 -----------------
@@ -14,7 +14,7 @@ There are other ways of processing source code. One that PHP supports natively i
 token stream generated by [`token_get_all`][2]. The token stream is much more low level than
 the AST and thus has different applications: It allows to also analyze the exact formatting of
 a file. On the other hand the token stream is much harder to deal with for more complex analysis.
-For example an AST abstracts away the fact that in PHP variables can be written as `$foo`, but also
+For example, an AST abstracts away the fact that, in PHP, variables can be written as `$foo`, but also
 as `$$bar`, `${'foobar'}` or even `${!${''}=barfoo()}`. You don't have to worry about recognizing
 all the different syntaxes from a stream of tokens.

@@ -26,17 +26,17 @@ programmatic PHP code analysis are incidentally PHP developers, not C developers
 What can it parse?
 ------------------

-The parser supports parsing PHP 5.2-5.6 and PHP 7.
+The parser supports parsing PHP 5.2-7.2.

 As the parser is based on the tokens returned by `token_get_all` (which is only able to lex the PHP
 version it runs on), additionally a wrapper for emulating tokens from newer versions is provided.
-This allows to parse PHP 7.1 source code running on PHP 5.5, for example. This emulation is somewhat
+This allows to parse PHP 7.2 source code running on PHP 5.5, for example. This emulation is somewhat
 hacky and not perfect, but it should work well on any sane code.

 What output does it produce?
 ----------------------------

-The parser produces an [Abstract Syntax Tree][1] (AST) also known as a node tree. How this looks like
+The parser produces an [Abstract Syntax Tree][1] (AST) also known as a node tree. How this looks
 can best be seen in an example. The program `<?php echo 'Hi', 'World';` will give you a node tree
 roughly looking like this:

--- a/doc/2_Usage_of_basic_components.markdown
+++ b/doc/2_Usage_of_basic_components.markdown
@@ -41,7 +41,7 @@ Kind | Behavior
 `ParserFactory::ONLY_PHP7` | Parse code as PHP 7.
 `ParserFactory::ONLY_PHP5` | Parse code as PHP 5.

-Unless you have strong reason to use something else, `PREFER_PHP7` is a reasonable default.
+Unless you have a strong reason to use something else, `PREFER_PHP7` is a reasonable default.

 The `create()` method optionally accepts a `Lexer` instance as the second argument. Some use cases
 that require customized lexers are discussed in the [lexer documentation](component/Lexer.markdown).
@@ -50,10 +50,18 @@ Subsequently you can pass PHP code (including the opening `<?php` tag) to the `p
 create a syntax tree. If a syntax error is encountered, an `PhpParser\Error` exception will be thrown:

 ```php
+<?php
 use PhpParser\Error;
 use PhpParser\ParserFactory;

-$code = '<?php // some code';
+$code = <<<'CODE'
+<?php
+function printLine($msg) {
+    echo $msg, "\n";
+}
+printLine('Hello World!!!');
+CODE;
+
 $parser = (new ParserFactory)->create(ParserFactory::PREFER_PHP7);

 try {
@@ -66,27 +74,68 @@ try {

 A parser instance can be reused to parse multiple files.

-Node tree
---------
+Node dumping
+------------

-If you use the above code with `$code = "<?php echo 'Hi ', hi\\getTarget();"` the parser will
-generate a node tree looking like this:
+To dump the abstact syntax tree in human readable form, a `NodeDumper` can be used:
+
+```php
+<?php
+use PhpParser\NodeDumper;
+
+$nodeDumper = new NodeDumper;
+echo $nodeDumper->dump($stmts), "\n";
+```
+
+For the sample code from the previous section, this will produce the following output:

 ```
 array(
-    0: Stmt_Echo(
-        exprs: array(
-            0: Scalar_String(
-                value: Hi
+    0: Stmt_Function(
+        byRef: false
+        name: Identifier(
+            name: printLine
+        )
+        params: array(
+            0: Param(
+                type: null
+                byRef: false
+                variadic: false
+                var: Expr_Variable(
+                    name: msg
+                )
+                default: null
            )
-            1: Expr_FuncCall(
-                name: Name(
-                    parts: array(
-                        0: hi
-                        1: getTarget
+        )
+        returnType: null
+        stmts: array(
+            0: Stmt_Echo(
+                exprs: array(
+                    0: Expr_Variable(
+                        name: msg
+                    )
+                    1: Scalar_String(
+                        value:
+
                    )
                )
-                args: array(
+            )
+        )
+    )
+    1: Stmt_Expression(
+        expr: Expr_FuncCall(
+            name: Name(
+                parts: array(
+                    0: printLine
+                )
+            )
+            args: array(
+                0: Arg(
+                    value: Scalar_String(
+                        value: Hello World!!!
+                    )
+                    byRef: false
+                    unpack: false
                )
            )
        )
@@ -94,10 +143,30 @@ array(
 )
 ```

-Thus `$stmts` will contain an array with only one node, with this node being an instance of
-`PhpParser\Node\Stmt\Echo_`.
+You can also use the `php-parse` script to obtain such a node dump by calling it either with a file
+name or code string:

-As PHP is a large language there are approximately 140 different nodes. In order to make work
+```sh
+vendor/bin/php-parse file.php
+vendor/bin/php-parse "<?php foo();"
+```
+
+This can be very helpful if you want to quickly check how certain syntax is represented in the AST.
+
+Node tree structure
+-------------------
+
+Looking at the node dump above, you can see that `$stmts` for this example code is an array of two
+nodes, a `Stmt_Function` and a `Stmt_Expression`. The corresponding class names are:
+
+ * `Stmt_Function -> PhpParser\Node\Stmt\Function_`
+ * `Stmt_Expression -> PhpParser\Node\Stmt\Expression`
+
+The additional `_` at the end of the first class name is necessary, because `Function` is a
+reserved keyword. Many node class names in this library have a trailing `_` to avoid clashing with
+a keyword.
+
+As PHP is a large language there are approximately 140 different nodes. In order to make working
 with them easier they are grouped into three categories:

 * `PhpParser\Node\Stmt`s are statement nodes, i.e. language constructs that do not return
@@ -113,8 +182,9 @@ with them easier they are grouped into three categories:
 * There are some nodes not in either of these groups, for example names (`PhpParser\Node\Name`)
   and call arguments (`PhpParser\Node\Arg`).

-Some node class names have a trailing `_`. This is used whenever the class name would otherwise clash
-with a PHP keyword.
+The `Node\Stmt\Expression` node is somewhat confusing in that it contains both the terms "statement"
+and "expression". This node distinguishes `expr`, which is a `Node\Expr`, from `expr;`, which is
+an "expression statement" represented by `Node\Stmt\Expression` and containing `expr` as a sub-node.

 Every node has a (possibly zero) number of subnodes. You can access subnodes by writing
 `$node->subNodeName`. The `Stmt\Echo_` node has only one subnode `exprs`. So in order to access it
@@ -173,7 +243,7 @@ try {

 The above code will output:

-    <?php echo 'Hello ', hi\getTarget();
+    echo 'Hello ', hi\getTarget();

 As you can see the source code was first parsed using `PhpParser\Parser->parse()`, then changed and then
 again converted to code using `PhpParser\PrettyPrinter\Standard->prettyPrint()`.
@@ -184,6 +254,8 @@ single expression using `prettyPrintExpr()`.
 The `prettyPrintFile()` method can be used to print an entire file. This will include the opening `<?php` tag
 and handle inline HTML as the first/last statement more gracefully.

+> Read more: [Pretty printing documentation](component/Pretty_printing.markdown)
+
 Node traversation
 -----------------

@@ -278,10 +350,12 @@ be `array(A, X, Y, Z, C)`.
 Instead of manually implementing the `NodeVisitor` interface you can also extend the `NodeVisitorAbstract`
 class, which will define empty default implementations for all the above methods.

+> Read more: [Walking the AST](component/Walking_the_AST.markdown)
+
 The NameResolver node visitor
 -----------------------------

-One visitor is already bundled with the package: `PhpParser\NodeVisitor\NameResolver`. This visitor
+One visitor that is already bundled with the package is `PhpParser\NodeVisitor\NameResolver`. This visitor
 helps you work with namespaced code by trying to resolve most names to fully qualified ones.

 For example, consider the following code:
@@ -292,7 +366,7 @@ For example, consider the following code:
 In order to know that `B\C` really is `A\C` you would need to track aliases and namespaces yourself.
 The `NameResolver` takes care of that and resolves names as far as possible.

-After running it most names will be fully qualified. The only names that will stay unqualified are
+After running it, most names will be fully qualified. The only names that will stay unqualified are
 unqualified function and constant names. These are resolved at runtime and thus the visitor can't
 know which function they are referring to. In most cases this is a non-issue as the global functions
 are meant.
@@ -300,6 +374,8 @@ are meant.
 Also the `NameResolver` adds a `namespacedName` subnode to class, function and constant declarations
 that contains the namespaced name instead of only the shortname that is available via `name`.

+> Read more: [Name resolution documentation](component/Name_resolution.markdown)
+
 Example: Converting namespaced code to pseudo namespaces
 --------------------------------------------------------

@@ -333,7 +409,7 @@ $files = new \RegexIterator($files, '/\.php$/');
 foreach ($files as $file) {
    try {
        // read the file that should be converted
-        $code = file_get_contents($file);
+        $code = file_get_contents($file->getPathName());

        // parse
        $stmts = $parser->parse($code);
--- a/doc/3_Other_node_tree_representations.markdown
+++ b/doc/3_Other_node_tree_representations.markdown
@@ -1,228 +0,0 @@
-Other node tree representations
-===============================
-
-It is possible to convert the AST into several textual representations, which serve different uses.
-
-Simple serialization
--------------------
-
-It is possible to serialize the node tree using `serialize()` and also unserialize it using
-`unserialize()`. The output is not human readable and not easily processable from anything
-but PHP, but it is compact and generates quickly. The main application thus is in caching.
-
-Human readable dumping
----------------------
-
-Furthermore it is possible to dump nodes into a human readable format using the `dump` method of
-`PhpParser\NodeDumper`. This can be used for debugging.
-
-```php
-$code = <<<'CODE'
-<?php
-
-function printLine($msg) {
-    echo $msg, "\n";
-}
-
-printLine('Hello World!!!');
-CODE;
-
-$parser = (new PhpParser\ParserFactory)->create(PhpParser\ParserFactory::PREFER_PHP7);
-$nodeDumper = new PhpParser\NodeDumper;
-
-try {
-    $stmts = $parser->parse($code);
-
-    echo $nodeDumper->dump($stmts), "\n";
-} catch (PhpParser\Error $e) {
-    echo 'Parse Error: ', $e->getMessage();
-}
-```
-
-The above script will have an output looking roughly like this:
-
-```
-array(
-    0: Stmt_Function(
-        byRef: false
-        params: array(
-            0: Param(
-                name: msg
-                default: null
-                type: null
-                byRef: false
-            )
-        )
-        stmts: array(
-            0: Stmt_Echo(
-                exprs: array(
-                    0: Expr_Variable(
-                        name: msg
-                    )
-                    1: Scalar_String(
-                        value:
-
-                    )
-                )
-            )
-        )
-        name: printLine
-    )
-    1: Expr_FuncCall(
-        name: Name(
-            parts: array(
-                0: printLine
-            )
-        )
-        args: array(
-            0: Arg(
-                value: Scalar_String(
-                    value: Hello World!!!
-                )
-                byRef: false
-            )
-        )
-    )
-)
-```
-
-JSON encoding
-------------
-
-Nodes (and comments) implement the `JsonSerializable` interface. As such, it is possible to JSON
-encode the AST directly using `json_encode()`:
-
-```php
-$code = <<<'CODE'
-<?php
-
-function printLine($msg) {
-    echo $msg, "\n";
-}
-
-printLine('Hello World!!!');
-CODE;
-
-$parser = (new PhpParser\ParserFactory)->create(PhpParser\ParserFactory::PREFER_PHP7);
-
-try {
-    $stmts = $parser->parse($code);
-
-    echo json_encode($stmts, JSON_PRETTY_PRINT), "\n";
-} catch (PhpParser\Error $e) {
-    echo 'Parse Error: ', $e->getMessage();
-}
-```
-
-This will result in the following output (which includes attributes):
-
-```json
-[
-    {
-        "nodeType": "Stmt_Function",
-        "byRef": false,
-        "name": "printLine",
-        "params": [
-            {
-                "nodeType": "Param",
-                "type": null,
-                "byRef": false,
-                "variadic": false,
-                "name": "msg",
-                "default": null,
-                "attributes": {
-                    "startLine": 3,
-                    "endLine": 3
-                }
-            }
-        ],
-        "returnType": null,
-        "stmts": [
-            {
-                "nodeType": "Stmt_Echo",
-                "exprs": [
-                    {
-                        "nodeType": "Expr_Variable",
-                        "name": "msg",
-                        "attributes": {
-                            "startLine": 4,
-                            "endLine": 4
-                        }
-                    },
-                    {
-                        "nodeType": "Scalar_String",
-                        "value": "\n",
-                        "attributes": {
-                            "startLine": 4,
-                            "endLine": 4,
-                            "kind": 2
-                        }
-                    }
-                ],
-                "attributes": {
-                    "startLine": 4,
-                    "endLine": 4
-                }
-            }
-        ],
-        "attributes": {
-            "startLine": 3,
-            "endLine": 5
-        }
-    },
-    {
-        "nodeType": "Expr_FuncCall",
-        "name": {
-            "nodeType": "Name",
-            "parts": [
-                "printLine"
-            ],
-            "attributes": {
-                "startLine": 7,
-                "endLine": 7
-            }
-        },
-        "args": [
-            {
-                "nodeType": "Arg",
-                "value": {
-                    "nodeType": "Scalar_String",
-                    "value": "Hello World!!!",
-                    "attributes": {
-                        "startLine": 7,
-                        "endLine": 7,
-                        "kind": 1
-                    }
-                },
-                "byRef": false,
-                "unpack": false,
-                "attributes": {
-                    "startLine": 7,
-                    "endLine": 7
-                }
-            }
-        ],
-        "attributes": {
-            "startLine": 7,
-            "endLine": 7
-        }
-    }
-]
-```
-
-The JSON representation may be converted back into a node tree using the `JsonDecoder`:
-
-```php
-<?php
-
-$nodeDecoder = new PhpParser\NodeDecoder();
-$ast = $nodeDecoder->decode($json);
-```
-
-Note that not all ASTs can be represented using JSON. In particular:
-
- * JSON only supports UTF-8 strings.
- * JSON does not support non-finite floating-point numbers. This can occur if the original source
-   code contains non-representable floating-pointing literals such as `1e1000`.
-
-If the node tree is not representable in JSON, the initial `json_encode()` call will fail.
--- a/doc/README.md
+++ b/doc/README.md
@@ -6,13 +6,17 @@ Guide

  1. [Introduction](0_Introduction.markdown)
  2. [Usage of basic components](2_Usage_of_basic_components.markdown)
-  3. [Other node tree representations](3_Other_node_tree_representations.markdown)
-  4. [Code generation](4_Code_generation.markdown)
-  5. [Frequently asked questions](5_FAQ.markdown)
- 
+
 Component documentation
 -----------------------
- 
+
+  * [Walking the AST](component/Walking_the_AST.markdown)
+    * Node visitors
+    * Modifying the AST from a visitor
+    * Short-circuiting traversals
+    * Interleaved visitors
+    * Simple node finding API
+    * Parent and sibling references
  * [Name resolution](component/Name_resolution.markdown)
    * Name resolver options
    * Name resolution context
@@ -20,6 +24,8 @@ Component documentation
    * Converting AST back to PHP code
    * Customizing formatting
    * Formatting-preserving code transformations
+  * [AST builders](component/AST_builders.markdown)
+    * Fluent builders for AST nodes
  * [Lexer](component/Lexer.markdown)
    * Lexer options
    * Token and file positions for nodes
@@ -27,7 +33,14 @@ Component documentation
  * [Error handling](component/Error_handling.markdown)
    * Column information for errors
    * Error recovery (parsing of syntactically incorrect code)
+  * [Constant expression evaluation](component/Constant_expression_evaluation.markdown)
+    * Evaluating constant/property/etc initializers
+    * Handling errors and unsupported expressions
+  * [JSON representation](component/JSON_representation.markdown)
+    * JSON encoding and decoding of ASTs
  * [Performance](component/Performance.markdown)
    * Disabling XDebug
    * Reusing objects
    * Garbage collection impact
+  * [Frequently asked questions](component/FAQ.markdown)
+    * Parent and sibling references
--- a/doc/component/AST_builders.markdown
+++ b/doc/component/AST_builders.markdown
@@ -1,9 +1,17 @@
-Code generation
-===============
+AST builders
+============

-It is also possible to generate code using the parser, by first creating an Abstract Syntax Tree and then using the
-pretty printer to convert it to PHP code. To simplify code generation, the project comes with builders which allow
-creating node trees using a fluid interface, instead of instantiating all nodes manually. Builders are available for
+When PHP-Parser is used to generate (or modify) code by first creating an Abstract Syntax Tree and
+then using the [pretty printer](Pretty_printing.markdown) to convert it to PHP code, it can often
+be tedious to manually construct AST nodes. The project provides a number of utilities to simplify
+the construction of common AST nodes.
+
+Fluent builders
+---------------
+
+The library comes with a number of builders, which allow creating node trees using a fluent
+interface. Builders are created using the `BuilderFactory` and the final constructed node is
+accessed through `getNode()`. Fluent builders are available for
 the following syntactic elements:

 * namespaces and use statements
@@ -82,3 +90,28 @@ abstract class SomeOtherClass extends SomeClass implements A\Few, \Interfaces
    }
 }
 ```
+
+Additional helper methods
+-------------------------
+
+The `BuilderFactory` also provides a number of additional helper methods, which directly return
+nodes. The following methods are currently available:
+
+ * `val($value)`: Creates an AST node for a literal value like `42` or `[1, 2, 3]`.
+ * `args(array $args)`: Creates an array of function/method arguments, including the required `Arg`
+   wrappers. Also converts literals to AST nodes.
+ * `funcCall($name, array $args = [])`: Create a function call node. Converts `$name` to a `Name`
+   node and normalizes arguments.
+ * `methodCall(Expr $var, $name, array $args = [])`: Create a method call node. Converts `$name` to
+   an `Identifier` node and normalizes arguments.
+ * `staticCall($class, $name, array $args = [])`: Create a static method call node. Converts
+   `$class` to a `Name` node, `$name` to an `Identifier` node and normalizes arguments.
+ * `new($class, array $args = [])`: Create a "new" (object creation) node. Converts `$class` to a
+   `Name` node.
+ * `constFetch($name)`: Create a constant fetch node. Converts `$name` to a `Name` node.
+ * `classConstFetch($class, $name)`: Create a class constant fetch node. Converts `$class` to a
+   `Name` node and `$name` to an `Identifier` node.
+ * `concat(...$exprs)`: Create a tree of `BinaryOp\Concat` nodes for the given expressions.
+
+These methods may be expanded on an as-needed basis. Please open an issue or PR if a common
+operation is missing.
--- a/doc/component/Constant_expression_evaluation.markdown
+++ b/doc/component/Constant_expression_evaluation.markdown
@@ -0,0 +1,115 @@
+Constant expression evaluation
+==============================
+
+Initializers for constants, properties, parameters, etc. have limited support for expressions. For
+example:
+
+```php
+<?php
+class Test {
+    const SECONDS_IN_HOUR = 60 * 60;
+    const SECONDS_IN_DAY = 24 * self::SECONDS_IN_HOUR;
+}
+```
+
+PHP-Parser supports evaluation of such constant expressions through the `ConstExprEvaluator` class:
+
+```php
+<?php
+
+use PhpParser\{ConstExprEvaluator, ConstExprEvaluationException};
+
+$evalutator = new ConstExprEvaluator();
+try {
+    $value = $evalutator->evaluateSilently($someExpr);
+} catch (ConstExprEvaluationException $e) {
+    // Either the expression contains unsupported expression types,
+    // or an error occurred during evaluation
+}
+```
+
+Error handling
+--------------
+
+The constant evaluator provides two methods, `evaluateDirectly()` and `evaluateSilently()`, which
+differ in error behavior. `evaluateDirectly()` will evaluate the expression as PHP would, including
+any generated warnings or Errors. `evaluateSilently()` will instead convert warnings and Errors into
+a `ConstExprEvaluationException`. For example:
+
+```php
+<?php
+
+use PhpParser\{ConstExprEvaluator, ConstExprEvaluationException};
+use PhpParser\Node\{Expr, Scalar};
+
+$evaluator = new ConstExprEvaluator();
+
+// 10 / 0
+$expr = new Expr\BinaryOp\Div(new Scalar\LNumber(10), new Scalar\LNumber(0));
+
+var_dump($evaluator->evaluateDirectly($expr)); // float(INF)
+// Warning: Division by zero
+
+try {
+    $evaluator->evaluateSilently($expr);
+} catch (ConstExprEvaluationException $e) {
+    var_dump($e->getPrevious()->getMessage()); // Division by zero
+}
+```
+
+For the purposes of static analysis, you will likely want to use `evaluateSilently()` and leave
+erroring expressions unevaluated.
+
+Unsupported expressions and evaluator fallback
+----------------------------------------------
+
+The constant expression evaluator supports all expression types that are permitted in constant
+expressions, apart from the following:
+
+ * `Scalar\MagicConst\*`
+ * `Expr\ConstFetch` (only null/false/true are handled)
+ * `Expr\ClassConstFetch`
+
+Handling these expression types requires non-local information, such as which global constants are
+defined. By default, the evaluator will throw a `ConstExprEvaluationException` when it encounters
+an unsupported expression type.
+
+It is possible to override this behavior and support resolution for these expression types by
+specifying an evaluation fallback function:
+
+```php
+<?php
+
+use PhpParser\{ConstExprEvaluator, ConstExprEvaluationException};
+use PhpParser\Node\Expr;
+
+$evalutator = new ConstExprEvaluator(function(Expr $expr) {
+    if ($expr instanceof Expr\ConstFetch) {
+        return fetchConstantSomehow($expr);
+    }
+    if ($expr instanceof Expr\ClassConstFetch) {
+        return fetchClassConstantSomehow($expr);
+    }
+    // etc.
+    throw new ConstExprEvaluationException(
+        "Expression of type {$expr->getType()} cannot be evaluated");
+});
+
+try {
+    $evalutator->evaluateSilently($someExpr);
+} catch (ConstExprEvaluationException $e) {
+    // Handle exception
+}
+```
+
+Implementers are advised to ensure that evaluation of indirect constant references cannot lead to
+infinite recursion. For example, the following code could lead to infinite recursion if constant
+lookup is implemented naively.
+
+```php
+<?php
+class Test {
+    const A = self::B;
+    const B = self::A;
+}
+```
--- a/doc/component/Error_handling.markdown
+++ b/doc/component/Error_handling.markdown
@@ -27,7 +27,7 @@ try {
 }
 ```

-Before using column information its availability needs to be checked with `$e->hasColumnInfo()`, as the precise
+Before using column information, its availability needs to be checked with `$e->hasColumnInfo()`, as the precise
 location of an error cannot always be determined. The methods for retrieving column information also have to be passed
 the source code of the parsed file. An example for printing an error:

--- a/doc/component/FAQ.markdown
+++ b/doc/component/FAQ.markdown
--- a/doc/component/JSON_representation.markdown
+++ b/doc/component/JSON_representation.markdown
@@ -0,0 +1,131 @@
+JSON representation
+===================
+
+Nodes (and comments) implement the `JsonSerializable` interface. As such, it is possible to JSON
+encode the AST directly using `json_encode()`:
+
+```php
+<?php
+
+use PhpParser\ParserFactory;
+
+$code = <<<'CODE'
+<?php
+
+/** @param string $msg */
+function printLine($msg) {
+    echo $msg, "\n";
+}
+CODE;
+
+$parser = (new ParserFactory)->create(ParserFactory::PREFER_PHP7);
+
+try {
+    $stmts = $parser->parse($code);
+
+    echo json_encode($stmts, JSON_PRETTY_PRINT), "\n";
+} catch (PhpParser\Error $e) {
+    echo 'Parse Error: ', $e->getMessage();
+}
+```
+
+This will result in the following output (which includes attributes):
+
+```json
+[
+    {
+        "nodeType": "Stmt_Function",
+        "byRef": false,
+        "name": {
+            "nodeType": "Identifier",
+            "name": "printLine",
+            "attributes": {
+                "startLine": 4,
+                "endLine": 4
+            }
+        },
+        "params": [
+            {
+                "nodeType": "Param",
+                "type": null,
+                "byRef": false,
+                "variadic": false,
+                "var": {
+                    "nodeType": "Expr_Variable",
+                    "name": "msg",
+                    "attributes": {
+                        "startLine": 4,
+                        "endLine": 4
+                    }
+                },
+                "default": null,
+                "attributes": {
+                    "startLine": 4,
+                    "endLine": 4
+                }
+            }
+        ],
+        "returnType": null,
+        "stmts": [
+            {
+                "nodeType": "Stmt_Echo",
+                "exprs": [
+                    {
+                        "nodeType": "Expr_Variable",
+                        "name": "msg",
+                        "attributes": {
+                            "startLine": 5,
+                            "endLine": 5
+                        }
+                    },
+                    {
+                        "nodeType": "Scalar_String",
+                        "value": "\n",
+                        "attributes": {
+                            "startLine": 5,
+                            "endLine": 5,
+                            "kind": 2
+                        }
+                    }
+                ],
+                "attributes": {
+                    "startLine": 5,
+                    "endLine": 5
+                }
+            }
+        ],
+        "attributes": {
+            "startLine": 4,
+            "comments": [
+                {
+                    "nodeType": "Comment_Doc",
+                    "text": "\/** @param string $msg *\/",
+                    "line": 3,
+                    "filePos": 9,
+                    "tokenPos": 2
+                }
+            ],
+            "endLine": 6
+        }
+    }
+]
+```
+
+The JSON representation may be converted back into an AST using the `JsonDecoder`:
+
+```php
+<?php
+
+$nodeDecoder = new PhpParser\NodeDecoder();
+$ast = $nodeDecoder->decode($json);
+```
+
+Note that not all ASTs can be represented using JSON. In particular:
+
+ * JSON only supports UTF-8 strings.
+ * JSON does not support non-finite floating-point numbers. This can occur if the original source
+   code contains non-representable floating-pointing literals such as `1e1000`.
+
+If the node tree is not representable in JSON, the initial `json_encode()` call will fail.
+
+From the command line, a JSON dump can be obtained using `vendor/bin/php-parse -j file.php`.
--- a/doc/component/Lexer.markdown
+++ b/doc/component/Lexer.markdown
@@ -107,9 +107,9 @@ function handleHaltCompiler(): string;
 function getNextToken(string &$value = null, array &$startAttributes = null, array &$endAttributes = null): int;
 ```

-The `startLexing()` method is invoked with the source code that is to be lexed (including the opening tag) whenever the
-`parse()` method of the parser is called. It can be used to reset state or preprocess the source code or tokens. The
-passes `ErrorHandler` should be used to report lexing errors.
+The `startLexing()` method is invoked whenever the `parse()` method of the parser is called and is passed the source
+code that is to be lexed (including the opening tag). It can be used to reset state or preprocess the source code or tokens. The
+passed `ErrorHandler` should be used to report lexing errors.

 The `getTokens()` method returns the current token array, in the usual `token_get_all()` format. This method is not
 used by the parser (which uses `getNextToken()`), but is useful in combination with the token position attributes.
--- a/doc/component/Performance.markdown
+++ b/doc/component/Performance.markdown
@@ -17,9 +17,9 @@ the `xdebug.default_enable=0` ini option does *not* disable XDebug. The *only* w
 XDebug is to not load the extension in the first place.

 If you are building a command-line utility for use by developers (who often have XDebug enabled),
-you may want to consider automatically restarting PHP with XDebug unloaded. See the composer
-[XdebugHandler](https://github.com/composer/composer/blob/master/src/Composer/XdebugHandler.php)
-for an implementation of such functionality.
+you may want to consider automatically restarting PHP with XDebug unloaded. The
+[composer/xdebug-handler](https://github.com/composer/xdebug-handler) package can be used to do
+this.

 If you do run with XDebug, you may need to increase the `xdebug.max_nesting_level` option to a
 higher level, such as 3000. While the parser itself is recursion free, most other code working on
--- a/doc/component/Pretty_printing.markdown
+++ b/doc/component/Pretty_printing.markdown
@@ -50,14 +50,13 @@ Formatting-preserving pretty printing

 For automated code refactoring, migration and similar, you will usually only want to modify a small
 portion of the code and leave the remainder alone. The basic pretty printer is not suitable for
-this, because it will also reformat parts of the code, which have not been modified.
+this, because it will also reformat parts of the code which have not been modified.

-Since PHP-Parser 4.0 an experimental formatting-preserving pretty-printing mode is available, which
-attempts to preserve the formatting of code, those AST nodes have not changed, and only reformat
+Since PHP-Parser 4.0, an experimental formatting-preserving pretty-printing mode is available, which
+attempts to preserve the formatting of code (those AST nodes that have not changed) and only reformat
 code which has been modified or newly inserted.

-Use of the formatting-preservation functionality currently requires some additional preparatory
-steps:
+Use of the formatting-preservation functionality requires some additional preparatory steps:

 ```php
 use PhpParser\{Lexer, NodeTraverser, NodeVisitor, Parser, PrettyPrinter};
@@ -86,6 +85,11 @@ $newStmts = $traverser->traverse($oldStmts);
 $newCode = $printer->printFormatPreserving($newStmts, $oldStmts, $oldTokens);
 ```

+If you make use of the name resolution functionality, you will likely want to disable the
+`replaceNodes` option. This will add resolved names as attributes, instead of directlying modifying
+the AST and causing spurious changes to the pretty printed code. For more information, see the
+[name resolution documentation](Name_resolution.markdown).
+
 This functionality is experimental and not yet fully implemented. It should not provide incorrect
 code, but it may sometimes reformat more code than necessary. Open issues are tracked in
 [issue #344](https://github.com/nikic/PHP-Parser/issues/344). If you encounter problems while using
--- a/doc/component/Walking_the_AST.markdown
+++ b/doc/component/Walking_the_AST.markdown
@@ -0,0 +1,335 @@
+Walking the AST
+===============
+
+The most common way to work with the AST is by using a node traverser and one or more node visitors.
+As a basic example, the following code changes all literal integers in the AST into strings (e.g.,
+`42` becomes `'42'`.)
+
+```php
+use PhpParser\{Node, NodeTraverser, NodeVisitorAbstract};
+
+$traverser = new NodeTraverser;
+$traverser->addVisitor(new class extends NodeVisitorAbstract {
+    public function leaveNode(Node $node) {
+        if ($node instanceof Node\Scalar\LNumber) {
+            return new Node\Scalar\String_((string) $node->value);
+        }
+    }
+});
+
+$stmts = ...;
+$modifiedStmts = $traverser->traverse($stmts);
+```
+
+Node visitors
+-------------
+
+Each node visitor implements an interface with following four methods:
+
+```php
+interface NodeVisitor {
+    public function beforeTraverse(array $nodes);
+    public function enterNode(Node $node);
+    public function leaveNode(Node $node);
+    public function afterTraverse(array $nodes);
+}
+```
+
+The `beforeTraverse()` and `afterTraverse()` methods are called before and after the traversal
+respectively, and are passed the entire AST. They can be used to perform any necessary state
+setup or cleanup.
+
+The `enterNode()` method is called when a node is first encountered, before its children are
+processed ("preorder"). The `leaveNode()` method is called after all children have been visited
+("postorder").
+
+For example, if we have the following excerpt of an AST
+
+```
+Expr_FuncCall(
+    name: Name(
+        parts: array(
+            0: printLine
+        )
+    )
+    args: array(
+        0: Arg(
+            value: Scalar_String(
+                value: Hello World!!!
+            )
+            byRef: false
+            unpack: false
+        )
+    )
+)
+```
+
+then the enter/leave methods will be called in the following order:
+
+```
+enterNode(Expr_FuncCall)
+enterNode(Name)
+leaveNode(Name)
+enterNode(Arg)
+enterNode(Scalar_String)
+leaveNode(Scalar_String)
+leaveNode(Arg)
+leaveNode(Expr_FuncCall)
+```
+
+A common pattern is that `enterNode` is used to collect some information and then `leaveNode`
+performs modifications based on that. At the time when `leaveNode` is called, all the code inside
+the node will have already been visited and necessary information collected.
+
+As you usually do not want to implement all four methods, it is recommended that you extend
+`NodeVisitorAbstract` instead of implementing the interface directly. The abstract class provides
+empty default implementations.
+
+Modifying the AST
+-----------------
+
+There are a number of ways in which the AST can be modified from inside a node visitor. The first
+and simplest is to simply change AST properties inside the visitor:
+
+```php
+public function leaveNode(Node $node) {
+    if ($node instanceof Node\Scalar\LNumber) {
+        // increment all integer literals
+        $node->value++;
+    }
+}
+```
+
+The second is to replace a node entirely by returning a new node:
+
+```php
+public function leaveNode(Node $node) {
+    if ($node instanceof Node\Expr\BinaryOp\BooleanAnd) {
+        // Convert all $a && $b expressions into !($a && $b)
+        return new Node\Expr\BooleanNot($node);
+    }
+}
+```
+
+Doing this is supported both inside enterNode and leaveNode. However, you have to be mindful about
+where you perform the replacement: If a node is replaced in enterNode, then the recursive traversal
+will also consider the children of the new node. If you aren't careful, this can lead to infinite
+recursion. For example, let's take the previous code sample and use enterNode instead:
+
+```php
+public function enterNode(Node $node) {
+    if ($node instanceof Node\Expr\BinaryOp\BooleanAnd) {
+        // Convert all $a && $b expressions into !($a && $b)
+        return new Node\Expr\BooleanNot($node);
+    }
+}
+```
+
+Now `$a && $b` will be replaced by `!($a && $b)`. Then the traverser will go into the first (and
+only) child of `!($a && $b)`, which is `$a && $b`. The transformation applies again and we end up
+with `!!($a && $b)`. This will continue until PHP hits the memory limit.
+
+Finally, two special replacement types are supported only by leaveNode. The first is removal of a
+node:
+
+```php
+public function leaveNode(Node $node) {
+    if ($node instanceof Node\Stmt\Return_) {
+        // Remove all return statements
+        return NodeTraverser::REMOVE_NODE;
+    }
+}
+```
+
+Node removal only works if the parent structure is an array. This means that usually it only makes
+sense to remove nodes of type `Node\Stmt`, as they always occur inside statement lists (and a few
+more node types like `Arg` or `Expr\ArrayItem`, which are also always part of lists).
+
+On the other hand, removing a `Node\Expr` does not make sense: If you have `$a * $b`, there is no
+meaningful way in which the `$a` part could be removed. If you want to remove an expression, you
+generally want to remove it together with a surrounding expression statement:
+
+```php
+public function leaveNode(Node $node) {
+    if ($node instanceof Node\Stmt\Expression
+        && $node->expr instanceof Node\Expr\FuncCall
+        && $node->expr->name instanceof Node\Name
+        && $node->expr->name->toString() === 'var_dump'
+    ) {
+        return NodeTraverser::REMOVE_NODE;
+    }
+}
+```
+
+This example will remove all calls to `var_dump()` which occur as expression statements. This means
+that `var_dump($a);` will be removed, but `if (var_dump($a))` will not be removed (and there is no
+obvious way in which it can be removed).
+
+Next to removing nodes, it is also possible to replace one node with multiple nodes. Again, this
+only works inside leaveNode and only if the parent structure is an array.
+
+```php
+public function leaveNode(Node $node) {
+    if ($node instanceof Node\Stmt\Return_ && $node->expr !== null) {
+        // Convert "return foo();" into "$retval = foo(); return $retval;"
+        $var = new Node\Expr\Variable('retval');
+        return [
+            new Node\Stmt\Expression(new Node\Expr\Assign($var, $node->expr)),
+            new Node\Stmt\Return_($var),
+        ];
+    }
+}
+```
+
+Short-circuiting traversal
+--------------------------
+
+An AST can easily contain thousands of nodes, and traversing over all of them may be slow,
+especially if you have more than one visitor. In some cases, it is possible to avoid a full
+traversal.
+
+If you are looking for all class declarations in a file (and assuming you're not interested in
+anonymous classes), you know that once you've seen a class declaration, there is no point in also
+checking all it's child nodes, because PHP does not allow nesting classes. In this case, you can
+instruct the traverser to not recurse into the class node:
+
+```
+private $classes = [];
+public function enterNode(Node $node) {
+    if ($node instanceof Node\Stmt\Class_) {
+        $this->classes[] = $node;
+        return NodeTraverser::DONT_TRAVERSE_CHILDREN;
+    }
+}
+```
+
+Of course, this option is only available in enterNode, because it's already too late by the time
+leaveNode is reached.
+
+If you are only looking for one specific node, it is also possible to abort the traversal entirely
+after finding it. For example, if you are looking for the node of a class with a certain name (and
+discounting exotic cases like conditionally defining a class two times), you can stop traversal
+once you found it:
+
+```
+private $class = null;
+public function enterNode(Node $node) {
+    if ($node instanceof Node\Stmt\Class_ &&
+        $node->namespaceName->toString() === 'Foo\Bar\Baz'
+    ) {
+        $this->class = $node;
+        return NodeTraverser::STOP_TRAVERSAL;
+    }
+}
+```
+
+This works both in enterNode and leaveNode. Note that this particular case can also be more easily
+handled using a NodeFinder, which will be introduced below.
+
+Multiple visitors
+-----------------
+
+A single traverser can be used with multiple visitors:
+
+```php
+$traverser = new NodeTraverser;
+$traverser->addVisitor($visitorA);
+$traverser->addVisitor($visitorB);
+$stmts = $traverser->traverser($stmts);
+```
+
+It is important to understand that if a traverser is run with multiple visitors, the visitors will
+be interleaved. Given the following AST excerpt
+
+```
+Stmt_Return(
+    expr: Expr_Variable(
+        name: foobar
+    )
+)
+```
+
+the following method calls will be performed:
+
+```
+$visitorA->enterNode(Stmt_Return)
+$visitorB->enterNode(Stmt_Return)
+$visitorA->enterNode(Expr_Variable)
+$visitorB->enterNode(Expr_Variable)
+$visitorA->leaveNode(Expr_Variable)
+$visitorB->leaveNode(Expr_Variable)
+$visitorA->leaveNode(Stmt_Return)
+$visitorB->leaveNode(Stmt_Return)
+```
+
+That is, when visiting a node, enterNode and leaveNode will always be called for all visitors.
+Running multiple visitors in parallel improves performance, as the AST only has to be traversed
+once. However, it is not always possible to write visitors in a way that allows interleaved
+execution. In this case, you can always fall back to performing multiple traversals:
+
+```php
+$traverserA = new NodeTraverser;
+$traverserA->addVisitor($visitorA);
+$traverserB = new NodeTraverser;
+$traverserB->addVisitor($visitorB);
+$stmts = $traverserA->traverser($stmts);
+$stmts = $traverserB->traverser($stmts);
+```
+
+When using multiple visitors, it is important to understand how they interact with the various
+special enterNode/leaveNode return values:
+
+ * If *any* visitor returns `DONT_TRAVERSE_CHILDREN`, the children will be skipped for *all*
+   visitors.
+ * If *any* visitor returns `STOP_TRAVERSAL`, traversal is stopped for *all* visitors.
+ * If a visitor returns a replacement node, subsequent visitors will be passed the replacement node,
+   not the original one.
+ * If a visitor returns `REMOVE_NODE`, subsequent visitors will not see this node.
+ * If a visitor returns an array of replacement nodes, subsequent visitors will see neither the node
+   that was replaced, nor the replacement nodes.
+
+Simple node finding
+-------------------
+
+While the node visitor mechanism is very flexible, creating a node visitor can be overly cumbersome
+for minor tasks. For this reason a `NodeFinder` is provided, which can find AST nodes that either
+satisfy a certain callback, or which are instanced of a certain node type. A couple of examples are
+shown in the following:
+
+```php
+use PhpParser\{Node, NodeFinder};
+
+$nodeFinder = new NodeFinder;
+
+// Find all class nodes.
+$classes = $nodeFinder->findInstanceOf($stmts, Node\Stmt\Class_::class);
+
+// Find all classes that extend another class
+$extendingClasses = $nodeFinder->findInstanceOf($stmts, function(Node $node) {
+    return $node instanceof Node\Stmt\Class_
+        && $node->extends !== null;
+});
+
+// Find first class occuring in the AST. Returns null if no class exists.
+$class = $nodeFinder->findFirstInstanceOf($stmts, Node\Stmt\Class_::class);
+
+// Find first class that has name $name
+$class = $nodeFinder->findFirst($stmts, function(Node $node) use ($name) {
+    return $node instanceof Node\Stmt\Class_
+        && $node->resolvedName->toString() === $name;
+});
+```
+
+Internally, the `NodeFinder` also uses a node traverser. It only simplifies the interface for a
+common use case.
+
+Parent and sibling references
+-----------------------------
+
+The node visitor mechanism is somewhat rigid, in that it prescribes an order in which nodes should
+be accessed: From parents to children. However, it can often be convenient to operate in the
+reverse direction: When working on a node, you might want to check if the parent node satisfies a
+certain property.
+
+PHP-Parser does not add parent (or sibling) references to nodes by itself, but you can easily
+emulate this with a visitor. See the [FAQ](FAQ.markdown) for more information.
--- a/grammar/parser.template
+++ b/grammar/parser.template
@@ -32,8 +32,8 @@ class #(-p) extends \PhpParser\ParserAbstract
    protected $defaultAction = #(YYDEFAULT);
    protected $unexpectedTokenRule = #(YYUNEXPECTED);

-    protected $YY2TBLSTATE  = #(YY2TBLSTATE);
-    protected $YYNLSTATES   = #(YYNLSTATES);
+    protected $YY2TBLSTATE = #(YY2TBLSTATE);
+    protected $numNonLeafStates = #(YYNLSTATES);

    protected $symbolToName = array(
        #listvar terminals
--- a/grammar/php5.y
+++ b/grammar/php5.y
@@ -335,8 +335,8 @@ case_list:
 ;

 case:
-      T_CASE expr case_separator inner_statement_list       { $$ = Stmt\Case_[$2, $4]; }
-    | T_DEFAULT case_separator inner_statement_list         { $$ = Stmt\Case_[null, $3]; }
+      T_CASE expr case_separator inner_statement_list_ex    { $$ = Stmt\Case_[$2, $4]; }
+    | T_DEFAULT case_separator inner_statement_list_ex      { $$ = Stmt\Case_[null, $3]; }
 ;

 case_separator:
@@ -454,11 +454,17 @@ static_var:
    | plain_variable '=' static_scalar                      { $$ = Stmt\StaticVar[$1, $3]; }
 ;

-class_statement_list:
-      class_statement_list class_statement                  { push($1, $2); }
+class_statement_list_ex:
+      class_statement_list_ex class_statement               { if ($2 !== null) { push($1, $2); } }
    | /* empty */                                           { init(); }
 ;

+class_statement_list:
+      class_statement_list_ex
+          { makeNop($nop, $this->lookaheadStartAttributes, $this->endAttributes);
+            if ($nop !== null) { $1[] = $nop; } $$ = $1; }
+;
+
 class_statement:
      variable_modifiers property_declaration_list ';'
          { $$ = Stmt\Property[$1, $2]; $this->checkProperty($$, #1); }
--- a/grammar/php7.y
+++ b/grammar/php7.y
@@ -240,6 +240,8 @@ non_empty_statement:
          { $$ = Stmt\Foreach_[$3, $5[0], ['keyVar' => null, 'byRef' => $5[1], 'stmts' => $7]]; }
    | T_FOREACH '(' expr T_AS variable T_DOUBLE_ARROW foreach_variable ')' foreach_statement
          { $$ = Stmt\Foreach_[$3, $7[0], ['keyVar' => $5, 'byRef' => $7[1], 'stmts' => $9]]; }
+    | T_FOREACH '(' expr error ')' foreach_statement
+          { $$ = Stmt\Foreach_[$3, new Expr\Error(stackAttributes(#4)), ['stmts' => $6]]; }
    | T_DECLARE '(' declare_list ')' declare_statement      { $$ = Stmt\Declare_[$3, $5]; }
    | T_TRY '{' inner_statement_list '}' catches optional_finally
          { $$ = Stmt\TryCatch[$3, $5, $6]; $this->checkTryCatch($$); }
@@ -277,7 +279,7 @@ optional_finally:
 ;

 variables_list:
-      non_empty_variables_list no_comma                     { $$ = $1; }
+      non_empty_variables_list optional_comma               { $$ = $1; }
 ;

 non_empty_variables_list:
@@ -295,9 +297,14 @@ optional_ellipsis:
    | T_ELLIPSIS                                            { $$ = true; }
 ;

+block_or_error:
+      '{' inner_statement_list '}'                          { $$ = $2; }
+    | error                                                 { $$ = []; }
+;
+
 function_declaration_statement:
-    T_FUNCTION optional_ref identifier '(' parameter_list ')' optional_return_type '{' inner_statement_list '}'
-        { $$ = Stmt\Function_[$3, ['byRef' => $2, 'params' => $5, 'returnType' => $7, 'stmts' => $9]]; }
+    T_FUNCTION optional_ref identifier '(' parameter_list ')' optional_return_type block_or_error
+        { $$ = Stmt\Function_[$3, ['byRef' => $2, 'params' => $5, 'returnType' => $7, 'stmts' => $8]]; }
 ;

 class_declaration_statement:
@@ -383,8 +390,8 @@ case_list:
 ;

 case:
-      T_CASE expr case_separator inner_statement_list       { $$ = Stmt\Case_[$2, $4]; }
-    | T_DEFAULT case_separator inner_statement_list         { $$ = Stmt\Case_[null, $3]; }
+      T_CASE expr case_separator inner_statement_list_ex    { $$ = Stmt\Case_[$2, $4]; }
+    | T_DEFAULT case_separator inner_statement_list_ex      { $$ = Stmt\Case_[null, $3]; }
 ;

 case_separator:
@@ -447,6 +454,8 @@ parameter:
          { $$ = Node\Param[$4, null, $1, $2, $3]; $this->checkParam($$); }
    | optional_param_type optional_ref optional_ellipsis plain_variable '=' expr
          { $$ = Node\Param[$4, $6, $1, $2, $3]; $this->checkParam($$); }
+    | optional_param_type optional_ref optional_ellipsis error
+          { $$ = Node\Param[Expr\Error[], null, $1, $2, $3]; }
 ;

 type_expr:
@@ -472,7 +481,7 @@ optional_return_type:

 argument_list:
      '(' ')'                                               { $$ = array(); }
-    | '(' non_empty_argument_list no_comma ')'              { $$ = $2; }
+    | '(' non_empty_argument_list optional_comma ')'        { $$ = $2; }
 ;

 non_empty_argument_list:
@@ -513,11 +522,17 @@ static_var:
    | plain_variable '=' expr                               { $$ = Stmt\StaticVar[$1, $3]; }
 ;

-class_statement_list:
-      class_statement_list class_statement                  { push($1, $2); }
+class_statement_list_ex:
+      class_statement_list_ex class_statement               { if ($2 !== null) { push($1, $2); } }
    | /* empty */                                           { init(); }
 ;

+class_statement_list:
+      class_statement_list_ex
+          { makeNop($nop, $this->lookaheadStartAttributes, $this->endAttributes);
+            if ($nop !== null) { $1[] = $nop; } $$ = $1; }
+;
+
 class_statement:
      variable_modifiers property_declaration_list ';'
          { $$ = Stmt\Property[$1, $2]; $this->checkProperty($$, #1); }
@@ -527,6 +542,7 @@ class_statement:
          { $$ = Stmt\ClassMethod[$4, ['type' => $1, 'byRef' => $3, 'params' => $6, 'returnType' => $8, 'stmts' => $9]];
            $this->checkClassMethod($$, #1); }
    | T_USE class_name_list trait_adaptations               { $$ = Stmt\TraitUse[$2, $3]; }
+    | error                                                 { $$ = null; /* will be skipped */ }
 ;

 trait_adaptations:
@@ -562,7 +578,7 @@ trait_method_reference:

 method_body:
      ';' /* abstract method */                             { $$ = null; }
-    | '{' inner_statement_list '}'                          { $$ = $2; }
+    | block_or_error                                        { $$ = $1; }
 ;

 variable_modifiers:
@@ -708,11 +724,11 @@ expr:
    | T_YIELD expr T_DOUBLE_ARROW expr                      { $$ = Expr\Yield_[$4, $2]; }
    | T_YIELD_FROM expr                                     { $$ = Expr\YieldFrom[$2]; }
    | T_FUNCTION optional_ref '(' parameter_list ')' lexical_vars optional_return_type
-      '{' inner_statement_list '}'
-          { $$ = Expr\Closure[['static' => false, 'byRef' => $2, 'params' => $4, 'uses' => $6, 'returnType' => $7, 'stmts' => $9]]; }
+      block_or_error
+          { $$ = Expr\Closure[['static' => false, 'byRef' => $2, 'params' => $4, 'uses' => $6, 'returnType' => $7, 'stmts' => $8]]; }
    | T_STATIC T_FUNCTION optional_ref '(' parameter_list ')' lexical_vars optional_return_type
-      '{' inner_statement_list '}'
-          { $$ = Expr\Closure[['static' => true, 'byRef' => $3, 'params' => $5, 'uses' => $7, 'returnType' => $8, 'stmts' => $10]]; }
+      block_or_error
+          { $$ = Expr\Closure[['static' => true, 'byRef' => $3, 'params' => $5, 'uses' => $7, 'returnType' => $8, 'stmts' => $9]]; }
 ;

 anonymous_class:
@@ -929,19 +945,26 @@ list_expr_elements:

 list_expr_element:
      variable                                              { $$ = Expr\ArrayItem[$1, null, false]; }
+    | '&' variable                                          { $$ = Expr\ArrayItem[$2, null, true]; }
    | list_expr                                             { $$ = Expr\ArrayItem[$1, null, false]; }
    | expr T_DOUBLE_ARROW variable                          { $$ = Expr\ArrayItem[$3, $1, false]; }
+    | expr T_DOUBLE_ARROW '&' variable                      { $$ = Expr\ArrayItem[$4, $1, true]; }
    | expr T_DOUBLE_ARROW list_expr                         { $$ = Expr\ArrayItem[$3, $1, false]; }
    | /* empty */                                           { $$ = null; }
 ;

 array_pair_list:
      inner_array_pair_list
-          { $$ = $1; $end = count($$)-1; if ($$[$end] === null) unset($$[$end]); }
+          { $$ = $1; $end = count($$)-1; if ($$[$end] === null) array_pop($$); }
+;
+
+comma_or_error:
+      ','
+    | error
 ;

 inner_array_pair_list:
-      inner_array_pair_list ',' array_pair                  { push($1, $3); }
+      inner_array_pair_list comma_or_error array_pair       { push($1, $3); }
    | array_pair                                            { init($1); }
 ;

--- a/lib/PhpParser/Autoloader.php
+++ b/lib/PhpParser/Autoloader.php
@@ -1,40 +0,0 @@
-<?php declare(strict_types=1);
-
-namespace PhpParser;
-
-/**
- * @codeCoverageIgnore
- */
-class Autoloader
-{
-    /** @var bool Whether the autoloader has been registered. */
-    private static $registered = false;
-
-    /**
-     * Registers PhpParser\Autoloader as an SPL autoloader.
-     *
-     * @param bool $prepend Whether to prepend the autoloader instead of appending
-     */
-    static public function register(bool $prepend = false) {
-        if (self::$registered === true) {
-            return;
-        }
-
-        spl_autoload_register([__CLASS__, 'autoload'], true, $prepend);
-        self::$registered = true;
-    }
-
-    /**
-     * Handles autoloading of classes.
-     *
-     * @param string $class A class name.
-     */
-    static public function autoload(string $class) {
-        if (0 === strpos($class, 'PhpParser\\')) {
-            $fileName = __DIR__ . strtr(substr($class, 9), '\\', '/') . '.php';
-            if (file_exists($fileName)) {
-                require $fileName;
-            }
-        }
-    }
-}
--- a/lib/PhpParser/Builder.php
+++ b/lib/PhpParser/Builder.php
@@ -10,4 +10,4 @@ interface Builder
     * @return Node The built node
     */
    public function getNode() : Node;
-}
+}
--- a/lib/PhpParser/Builder/Class_.php
+++ b/lib/PhpParser/Builder/Class_.php
@@ -90,18 +90,18 @@ class Class_ extends Declaration
        $stmt = BuilderHelpers::normalizeNode($stmt);

        $targets = [
-            'Stmt_TraitUse'    => &$this->uses,
-            'Stmt_ClassConst'  => &$this->constants,
-            'Stmt_Property'    => &$this->properties,
-            'Stmt_ClassMethod' => &$this->methods,
+            Stmt\TraitUse::class    => &$this->uses,
+            Stmt\ClassConst::class  => &$this->constants,
+            Stmt\Property::class    => &$this->properties,
+            Stmt\ClassMethod::class => &$this->methods,
        ];

-        $type = $stmt->getType();
-        if (!isset($targets[$type])) {
-            throw new \LogicException(sprintf('Unexpected node of type "%s"', $type));
+        $class = \get_class($stmt);
+        if (!isset($targets[$class])) {
+            throw new \LogicException(sprintf('Unexpected node of type "%s"', $stmt->getType()));
        }

-        $targets[$type][] = $stmt;
+        $targets[$class][] = $stmt;

        return $this;
    }
@@ -119,4 +119,4 @@ class Class_ extends Declaration
            'stmts' => array_merge($this->uses, $this->constants, $this->properties, $this->methods),
        ], $this->attributes);
    }
-}
+}
--- a/lib/PhpParser/Builder/Declaration.php
+++ b/lib/PhpParser/Builder/Declaration.php
@@ -40,4 +40,4 @@ abstract class Declaration implements PhpParser\Builder

        return $this;
    }
-}
+}
--- a/lib/PhpParser/Builder/Interface_.php
+++ b/lib/PhpParser/Builder/Interface_.php
@@ -48,20 +48,14 @@ class Interface_ extends Declaration
    public function addStmt($stmt) {
        $stmt = BuilderHelpers::normalizeNode($stmt);

-        $type = $stmt->getType();
-        switch ($type) {
-            case 'Stmt_ClassConst':
-                $this->constants[] = $stmt;
-                break;
-
-            case 'Stmt_ClassMethod':
-                // we erase all statements in the body of an interface method
-                $stmt->stmts = null;
-                $this->methods[] = $stmt;
-                break;
-
-            default:
-                throw new \LogicException(sprintf('Unexpected node of type "%s"', $type));
+        if ($stmt instanceof Stmt\ClassConst) {
+            $this->constants[] = $stmt;
+        } elseif ($stmt instanceof Stmt\ClassMethod) {
+            // we erase all statements in the body of an interface method
+            $stmt->stmts = null;
+            $this->methods[] = $stmt;
+        } else {
+            throw new \LogicException(sprintf('Unexpected node of type "%s"', $stmt->getType()));
        }

        return $this;
@@ -78,4 +72,4 @@ class Interface_ extends Declaration
            'stmts' => array_merge($this->constants, $this->methods),
        ], $this->attributes);
    }
-}
+}
--- a/lib/PhpParser/Builder/Property.php
+++ b/lib/PhpParser/Builder/Property.php
@@ -109,4 +109,4 @@ class Property implements PhpParser\Builder
            $this->attributes
        );
    }
-}
+}
--- a/lib/PhpParser/Builder/Trait_.php
+++ b/lib/PhpParser/Builder/Trait_.php
@@ -34,9 +34,9 @@ class Trait_ extends Declaration

        if ($stmt instanceof Stmt\Property) {
            $this->properties[] = $stmt;
-        } else if ($stmt instanceof Stmt\ClassMethod) {
+        } elseif ($stmt instanceof Stmt\ClassMethod) {
            $this->methods[] = $stmt;
-        } else if ($stmt instanceof Stmt\TraitUse) {
+        } elseif ($stmt instanceof Stmt\TraitUse) {
            $this->uses[] = $stmt;
        } else {
            throw new \LogicException(sprintf('Unexpected node of type "%s"', $stmt->getType()));
--- a/lib/PhpParser/Builder/Use_.php
+++ b/lib/PhpParser/Builder/Use_.php
@@ -7,7 +7,8 @@ use PhpParser\BuilderHelpers;
 use PhpParser\Node;
 use PhpParser\Node\Stmt;

-class Use_ implements Builder {
+class Use_ implements Builder
+{
    protected $name;
    protected $type;
    protected $alias = null;
--- a/lib/PhpParser/BuilderFactory.php
+++ b/lib/PhpParser/BuilderFactory.php
@@ -5,7 +5,10 @@ namespace PhpParser;
 use PhpParser\Node\Arg;
 use PhpParser\Node\Expr;
 use PhpParser\Node\Expr\BinaryOp\Concat;
+use PhpParser\Node\Identifier;
+use PhpParser\Node\Name;
 use PhpParser\Node\Scalar\String_;
+use PhpParser\Node\Stmt;
 use PhpParser\Node\Stmt\Use_;

 class BuilderFactory
@@ -101,7 +104,7 @@ class BuilderFactory
    /**
     * Creates a namespace/class use builder.
     *
-     * @param string|Node\Name Name to alias
+     * @param string|Node\Name $name Name to alias
     *
     * @return Builder\Use_ The create use builder
     */
@@ -141,6 +144,96 @@ class BuilderFactory
        return $normalizedArgs;
    }

+    /**
+     * Creates a function call node.
+     *
+     * @param string|Name|Expr $name Function name
+     * @param array            $args Function arguments
+     *
+     * @return Expr\FuncCall
+     */
+    public function funcCall($name, array $args = []) : Expr\FuncCall {
+        return new Expr\FuncCall(
+            BuilderHelpers::normalizeNameOrExpr($name),
+            $this->args($args)
+        );
+    }
+
+    /**
+     * Creates a method call node.
+     *
+     * @param Expr                   $var  Variable the method is called on
+     * @param string|Identifier|Expr $name Method name
+     * @param array                  $args Method arguments
+     *
+     * @return Expr\MethodCall
+     */
+    public function methodCall(Expr $var, $name, array $args = []) : Expr\MethodCall {
+        return new Expr\MethodCall(
+            $var,
+            BuilderHelpers::normalizeIdentifierOrExpr($name),
+            $this->args($args)
+        );
+    }
+
+    /**
+     * Creates a static method call node.
+     *
+     * @param string|Name|Expr       $class Class name
+     * @param string|Identifier|Expr $name  Method name
+     * @param array                  $args  Method arguments
+     *
+     * @return Expr\StaticCall
+     */
+    public function staticCall($class, $name, array $args = []) : Expr\StaticCall {
+        return new Expr\StaticCall(
+            BuilderHelpers::normalizeNameOrExpr($class),
+            BuilderHelpers::normalizeIdentifierOrExpr($name),
+            $this->args($args)
+        );
+    }
+
+    /**
+     * Creates an object creation node.
+     *
+     * @param string|Name|Expr $class Class name
+     * @param array            $args  Constructor arguments
+     *
+     * @return Expr\New_
+     */
+    public function new($class, array $args = []) : Expr\New_ {
+        return new Expr\New_(
+            BuilderHelpers::normalizeNameOrExpr($class),
+            $this->args($args)
+        );
+    }
+
+    /**
+     * Creates a constant fetch node.
+     *
+     * @param string|Name $name Constant name
+     *
+     * @return Expr\ConstFetch
+     */
+    public function constFetch($name) : Expr\ConstFetch {
+        return new Expr\ConstFetch(BuilderHelpers::normalizeName($name));
+    }
+
+    /**
+     * Creates a class constant fetch node.
+     *
+     * @param string|Name|Expr  $class Class name
+     * @param string|Identifier $name  Constant name
+     *
+     * @return Expr\ClassConstFetch
+     */
+    public function classConstFetch($class, $name): Expr\ClassConstFetch {
+        return new Expr\ClassConstFetch(
+            BuilderHelpers::normalizeNameOrExpr($class),
+            BuilderHelpers::normalizeIdentifier($name)
+        );
+    }
+
    /**
     * Creates nested Concat nodes from a list of expressions.
     *
@@ -161,12 +254,16 @@ class BuilderFactory
        return $lastConcat;
    }

-    private function normalizeStringExpr($expr) {
+    /**
+     * @param string|Expr $expr
+     * @return Expr
+     */
+    private function normalizeStringExpr($expr) : Expr {
        if ($expr instanceof Expr) {
            return $expr;
        }

-        if (is_string($expr)) {
+        if (\is_string($expr)) {
            return new String_($expr);
        }

--- a/lib/PhpParser/BuilderHelpers.php
+++ b/lib/PhpParser/BuilderHelpers.php
@@ -14,7 +14,8 @@ use PhpParser\Node\Stmt;
 *
 * @internal
 */
-final class BuilderHelpers {
+final class BuilderHelpers
+{
    /**
     * Normalizes a node: Converts builder objects to nodes.
     *
@@ -55,13 +56,74 @@ final class BuilderHelpers {
    }

    /**
-     * Normalizes a name: Converts plain string names to PhpParser\Node\Name.
+     * Normalizes strings to Identifier.
+     *
+     * @param string|Identifier $name The identifier to normalize
+     *
+     * @return Identifier The normalized identifier
+     */
+    public static function normalizeIdentifier($name) : Identifier {
+        if ($name instanceof Identifier) {
+            return $name;
+        }
+
+        if (\is_string($name)) {
+            return new Identifier($name);
+        }
+
+        throw new \LogicException('Expected string or instance of Node\Identifier or Node\Expr');
+    }
+
+    /**
+     * Normalizes strings to Identifier, also allowing expressions.
+     *
+     * @param string|Identifier|Expr $name The identifier to normalize
+     *
+     * @return Identifier|Expr The normalized identifier or expression
+     */
+    public static function normalizeIdentifierOrExpr($name) {
+        if ($name instanceof Identifier || $name instanceof Expr) {
+            return $name;
+        }
+
+        if (\is_string($name)) {
+            return new Identifier($name);
+        }
+
+        throw new \LogicException('Expected string or instance of Node\Identifier or Node\Expr');
+    }
+
+    /**
+     * Normalizes a name: Converts string names to Name nodes.
     *
     * @param Name|string $name The name to normalize
     *
     * @return Name The normalized name
     */
    public static function normalizeName($name) : Name {
+        return self::normalizeNameCommon($name, false);
+    }
+
+    /**
+     * Normalizes a name: Converts string names to Name nodes, while also allowing expressions.
+     *
+     * @param Expr|Name|string $name The name to normalize
+     *
+     * @return Name|Expr The normalized name or expression
+     */
+    public static function normalizeNameOrExpr($name) {
+        return self::normalizeNameCommon($name, true);
+    }
+
+    /**
+     * Normalizes a name: Converts string names to Name nodes, optionally allowing expressions.
+     *
+     * @param Expr|Name|string $name      The name to normalize
+     * @param bool             $allowExpr Whether to also allow expressions
+     *
+     * @return Name|Expr The normalized name, or expression (if allowed)
+     */
+    private static function normalizeNameCommon($name, bool $allowExpr) {
        if ($name instanceof Name) {
            return $name;
        } elseif (is_string($name)) {
@@ -78,7 +140,16 @@ final class BuilderHelpers {
            }
        }

-        throw new \LogicException('Name must be a string or an instance of PhpParser\Node\Name');
+        if ($allowExpr) {
+            if ($name instanceof Expr) {
+                return $name;
+            }
+            throw new \LogicException(
+                'Name must be a string or an instance of Node\Name or Node\Expr'
+            );
+        } else {
+            throw new \LogicException('Name must be a string or an instance of Node\Name');
+        }
    }

    /**
@@ -184,7 +255,7 @@ final class BuilderHelpers {
    public static function normalizeDocComment($docComment) : Comment\Doc {
        if ($docComment instanceof Comment\Doc) {
            return $docComment;
-        } else if (is_string($docComment)) {
+        } elseif (is_string($docComment)) {
            return new Comment\Doc($docComment);
        } else {
            throw new \LogicException('Doc comment must be a string or an instance of PhpParser\Comment\Doc');
--- a/lib/PhpParser/Comment.php
+++ b/lib/PhpParser/Comment.php
@@ -164,4 +164,4 @@ class Comment implements \JsonSerializable
            'tokenPos' => $this->tokenPos,
        ];
    }
-}
+}
--- a/lib/PhpParser/Comment/Doc.php
+++ b/lib/PhpParser/Comment/Doc.php
@@ -4,4 +4,4 @@ namespace PhpParser\Comment;

 class Doc extends \PhpParser\Comment
 {
-}
+}
--- a/lib/PhpParser/ConstExprEvaluationException.php
+++ b/lib/PhpParser/ConstExprEvaluationException.php
@@ -2,4 +2,5 @@

 namespace PhpParser;

-class ConstExprEvaluationException extends \Exception {}
+class ConstExprEvaluationException extends \Exception
+{}
--- a/lib/PhpParser/ConstExprEvaluator.php
+++ b/lib/PhpParser/ConstExprEvaluator.php
@@ -20,15 +20,12 @@ use PhpParser\Node\Scalar;
 *
 * The fallback evaluator should throw ConstExprEvaluationException for nodes it cannot evaluate.
 *
- * The evaluation is performed as PHP would perform it, and as such may generate notices, warnings
- * or Errors. For example, if the expression `1%0` is evaluated, an ArithmeticError is thrown. It is
- * left to the consumer to handle these as appropriate.
- *
- * The evaluation is also dependent on runtime configuration in two respects: Firstly, floating
+ * The evaluation is dependent on runtime configuration in two respects: Firstly, floating
 * point to string conversions are affected by the precision ini setting. Secondly, they are also
 * affected by the LC_NUMERIC locale.
 */
-class ConstExprEvaluator {
+class ConstExprEvaluator
+{
    private $fallbackEvaluator;

    /**
@@ -48,7 +45,10 @@ class ConstExprEvaluator {
    }

    /**
-     * Evaluates a constant expression into a PHP value.
+     * Silently evaluates a constant expression into a PHP value.
+     *
+     * Thrown Errors, warnings or notices will be converted into a ConstExprEvaluationException.
+     * The original source of the exception is available through getPrevious().
     *
     * If some part of the expression cannot be evaluated, the fallback evaluator passed to the
     * constructor will be invoked. By default, if no fallback is provided, an exception of type
@@ -58,9 +58,49 @@ class ConstExprEvaluator {
     *
     * @param Expr $expr Constant expression to evaluate
     * @return mixed Result of evaluation
+     *
+     * @throws ConstExprEvaluationException if the expression cannot be evaluated or an error occurred
+     */
+    public function evaluateSilently(Expr $expr) {
+        set_error_handler(function($num, $str, $file, $line) {
+            throw new \ErrorException($str, 0, $num, $file, $line);
+        });
+
+        try {
+            return $this->evaluate($expr);
+        } catch (\Throwable $e) {
+            if (!$e instanceof ConstExprEvaluationException) {
+                $e = new ConstExprEvaluationException(
+                    "An error occurred during constant expression evaluation", 0, $e);
+            }
+            throw $e;
+        } finally {
+            restore_error_handler();
+        }
+    }
+
+    /**
+     * Directly evaluates a constant expression into a PHP value.
+     *
+     * May generate Error exceptions, warnings or notices. Use evaluateSilently() to convert these
+     * into a ConstExprEvaluationException.
+     *
+     * If some part of the expression cannot be evaluated, the fallback evaluator passed to the
+     * constructor will be invoked. By default, if no fallback is provided, an exception of type
+     * ConstExprEvaluationException is thrown.
+     *
+     * See class doc comment for caveats and limitations.
+     *
+     * @param Expr $expr Constant expression to evaluate
+     * @return mixed Result of evaluation
+     *
     * @throws ConstExprEvaluationException if the expression cannot be evaluated
     */
-    public function evaluate(Expr $expr) {
+    public function evaluateDirectly(Expr $expr) {
+        return $this->evaluate($expr);
+    }
+
+    private function evaluate(Expr $expr) {
        if ($expr instanceof Scalar\LNumber
            || $expr instanceof Scalar\DNumber
            || $expr instanceof Scalar\String_
@@ -183,4 +223,4 @@ class ConstExprEvaluator {

        return ($this->fallbackEvaluator)($expr);
    }
-}
+}
--- a/lib/PhpParser/Error.php
+++ b/lib/PhpParser/Error.php
@@ -15,7 +15,7 @@ class Error extends \RuntimeException
     *                              (or start line of error -- deprecated)
     */
    public function __construct(string $message, $attributes = []) {
-        $this->rawMessage = (string) $message;
+        $this->rawMessage = $message;
        if (is_array($attributes)) {
            $this->attributes = $attributes;
        } else {
@@ -51,7 +51,6 @@ class Error extends \RuntimeException
        return $this->attributes['endLine'] ?? -1;
    }

-
    /**
     * Gets the attributes of the node/token the error occurred at.
     *
@@ -62,7 +61,7 @@ class Error extends \RuntimeException
    }

    /**
-     * Sets the attributes of the node/token the error occured at.
+     * Sets the attributes of the node/token the error occurred at.
     *
     * @param array $attributes
     */
@@ -77,7 +76,7 @@ class Error extends \RuntimeException
     * @param string $message Error message
     */
    public function setRawMessage(string $message) {
-        $this->rawMessage = (string) $message;
+        $this->rawMessage = $message;
        $this->updateMessage();
    }

@@ -87,7 +86,7 @@ class Error extends \RuntimeException
     * @param int $line Error start line
     */
    public function setStartLine(int $line) {
-        $this->attributes['startLine'] = (int) $line;
+        $this->attributes['startLine'] = $line;
        $this->updateMessage();
    }

@@ -99,7 +98,7 @@ class Error extends \RuntimeException
     * @return bool
     */
    public function hasColumnInfo() : bool {
-        return isset($this->attributes['startFilePos']) && isset($this->attributes['endFilePos']);
+        return isset($this->attributes['startFilePos'], $this->attributes['endFilePos']);
    }

    /**
--- a/lib/PhpParser/ErrorHandler.php
+++ b/lib/PhpParser/ErrorHandler.php
@@ -10,4 +10,4 @@ interface ErrorHandler
     * @param Error $error The error that needs to be handled
     */
    public function handleError(Error $error);
-}
+}
--- a/lib/PhpParser/ErrorHandler/Collecting.php
+++ b/lib/PhpParser/ErrorHandler/Collecting.php
@@ -43,4 +43,4 @@ class Collecting implements ErrorHandler
    public function clearErrors() {
        $this->errors = [];
    }
-}
+}
--- a/lib/PhpParser/ErrorHandler/Throwing.php
+++ b/lib/PhpParser/ErrorHandler/Throwing.php
@@ -15,4 +15,4 @@ class Throwing implements ErrorHandler
    public function handleError(Error $error) {
        throw $error;
    }
-}
+}
--- a/lib/PhpParser/Internal/DiffElem.php
+++ b/lib/PhpParser/Internal/DiffElem.php
@@ -5,7 +5,8 @@ namespace PhpParser\Internal;
 /**
 * @internal
 */
-class DiffElem {
+class DiffElem
+{
    const TYPE_KEEP = 0;
    const TYPE_REMOVE = 1;
    const TYPE_ADD = 2;
@@ -23,4 +24,4 @@ class DiffElem {
        $this->old = $old;
        $this->new = $new;
    }
-}
+}
--- a/lib/PhpParser/Internal/Differ.php
+++ b/lib/PhpParser/Internal/Differ.php
@@ -10,13 +10,14 @@ namespace PhpParser\Internal;
 *
 * @internal
 */
-class Differ {
+class Differ
+{
    private $isEqual;

    /**
     * Create differ over the given equality relation.
     *
-     * @param callable $isEqual Equality relation with signature function($a, $b): bool
+     * @param callable $isEqual Equality relation with signature function($a, $b) : bool
     */
    public function __construct(callable $isEqual) {
        $this->isEqual = $isEqual;
@@ -160,4 +161,4 @@ class Differ {
        }
        return $newDiff;
    }
-}
+}
--- a/lib/PhpParser/Internal/PrintableNewAnonClassNode.php
+++ b/lib/PhpParser/Internal/PrintableNewAnonClassNode.php
@@ -15,7 +15,8 @@ use PhpParser\Node\Expr;
 *
 * @internal
 */
-class PrintableNewAnonClassNode extends Expr  {
+class PrintableNewAnonClassNode extends Expr
+{
    /** @var Node\Arg[] Arguments */
    public $args;
    /** @var null|Node\Name Name of extended class */
@@ -45,11 +46,11 @@ class PrintableNewAnonClassNode extends Expr  {
        );
    }

-    public function getType(): string {
+    public function getType() : string {
        return 'Expr_PrintableNewAnonClass';
    }

    public function getSubNodeNames() : array {
        return ['args', 'extends', 'implements', 'stmts'];
    }
-}
+}
--- a/lib/PhpParser/Internal/TokenStream.php
+++ b/lib/PhpParser/Internal/TokenStream.php
@@ -1,13 +1,14 @@
 <?php declare(strict_types=1);

-namespace PhpParser;
+namespace PhpParser\Internal;

 /**
 * Provides operations on token streams, for use by pretty printer.
 *
 * @internal
 */
-class TokenStream {
+class TokenStream
+{
    /** @var array Tokens (in token_get_all format) */
    private $tokens;
    /** @var int[] Map from position to indentation */
@@ -214,7 +215,7 @@ class TokenStream {
                    // TODO Handle non-space indentation
                    if ($indent < 0) {
                        $result .= str_replace("\n" . str_repeat(" ", -$indent), "\n", $content);
-                    } else if ($indent > 0) {
+                    } elseif ($indent > 0) {
                        $result .= str_replace("\n", "\n" . str_repeat(" ", $indent), $content);
                    } else {
                        $result .= $content;
@@ -252,4 +253,4 @@ class TokenStream {

        return $indentMap;
    }
-}
+}
--- a/lib/PhpParser/JsonDecoder.php
+++ b/lib/PhpParser/JsonDecoder.php
@@ -2,7 +2,8 @@

 namespace PhpParser;

-class JsonDecoder {
+class JsonDecoder
+{
    /** @var \ReflectionClass[] Node type to reflection class map */
    private $reflectionClassCache;

@@ -97,4 +98,4 @@ class JsonDecoder {

        throw new \RuntimeException("Unknown node type \"$nodeType\"");
    }
-}
+}
--- a/lib/PhpParser/Lexer.php
+++ b/lib/PhpParser/Lexer.php
@@ -153,7 +153,7 @@ class Lexer
                $nextFilePos = strpos($this->code, $tokenValue, $filePos);
                $this->handleInvalidCharacterRange(
                    $filePos, $nextFilePos, $line, $errorHandler);
-                $filePos = (int)$nextFilePos;
+                $filePos = (int) $nextFilePos;
            }

            $filePos += $tokenLen;
@@ -255,7 +255,7 @@ class Lexer
                $id = $this->tokenMap[$token[0]];
                if (\T_CLOSE_TAG === $token[0]) {
                    $this->prevCloseTagHasNewline = false !== strpos($token[1], "\n");
-                } else if (\T_INLINE_HTML === $token[0]) {
+                } elseif (\T_INLINE_HTML === $token[0]) {
                    $startAttributes['hasLeadingNewline'] = $this->prevCloseTagHasNewline;
                }

@@ -357,7 +357,7 @@ class Lexer
                if ('T_HASHBANG' === $name) {
                    // HHVM uses a special token for #! hashbang lines
                    $tokenMap[$i] = Tokens::T_INLINE_HTML;
-                } else if (defined($name = 'PhpParser\Parser\Tokens::' . $name)) {
+                } elseif (defined($name = Tokens::class . '::' . $name)) {
                    // Other tokens can be mapped directly
                    $tokenMap[$i] = constant($name);
                }
--- a/lib/PhpParser/Lexer/Emulative.php
+++ b/lib/PhpParser/Lexer/Emulative.php
@@ -2,8 +2,7 @@

 namespace PhpParser\Lexer;

-
 class Emulative extends \PhpParser\Lexer
 {
    /* No features requiring emulation have been added in PHP > 7.0 */
-}
+}
--- a/lib/PhpParser/NameContext.php
+++ b/lib/PhpParser/NameContext.php
@@ -6,7 +6,8 @@ use PhpParser\Node\Name;
 use PhpParser\Node\Name\FullyQualified;
 use PhpParser\Node\Stmt;

-class NameContext {
+class NameContext
+{
    /** @var null|Name Current namespace */
    protected $namespace;

@@ -281,4 +282,4 @@ class NameContext {
        $shortName = substr($name, $nsSep + 1);
        return strtolower($ns) . '\\' . $shortName;
    }
-}
+}
--- a/lib/PhpParser/Node.php
+++ b/lib/PhpParser/Node.php
@@ -90,7 +90,7 @@ interface Node
     *
     * @return Comment[]
     */
-    public function getComments(): array;
+    public function getComments() : array;

    /**
     * Gets the doc comment of the node.
--- a/lib/PhpParser/Node/Arg.php
+++ b/lib/PhpParser/Node/Arg.php
@@ -31,4 +31,8 @@ class Arg extends NodeAbstract
    public function getSubNodeNames() : array {
        return ['value', 'byRef', 'unpack'];
    }
+    
+    public function getType() : string {
+        return 'Arg';
+    }
 }
--- a/lib/PhpParser/Node/Const_.php
+++ b/lib/PhpParser/Node/Const_.php
@@ -30,4 +30,8 @@ class Const_ extends NodeAbstract
    public function getSubNodeNames() : array {
        return ['name', 'value'];
    }
+    
+    public function getType() : string {
+        return 'Const';
+    }
 }
--- a/lib/PhpParser/Node/Expr.php
+++ b/lib/PhpParser/Node/Expr.php
@@ -6,4 +6,4 @@ use PhpParser\NodeAbstract;

 abstract class Expr extends NodeAbstract
 {
-}
+}
--- a/lib/PhpParser/Node/Expr/ArrayDimFetch.php
+++ b/lib/PhpParser/Node/Expr/ArrayDimFetch.php
@@ -27,4 +27,8 @@ class ArrayDimFetch extends Expr
    public function getSubNodeNames() : array {
        return ['var', 'dim'];
    }
+    
+    public function getType() : string {
+        return 'Expr_ArrayDimFetch';
+    }
 }
--- a/lib/PhpParser/Node/Expr/ArrayItem.php
+++ b/lib/PhpParser/Node/Expr/ArrayItem.php
@@ -31,4 +31,8 @@ class ArrayItem extends Expr
    public function getSubNodeNames() : array {
        return ['key', 'value', 'byRef'];
    }
+    
+    public function getType() : string {
+        return 'Expr_ArrayItem';
+    }
 }
--- a/lib/PhpParser/Node/Expr/Array_.php
+++ b/lib/PhpParser/Node/Expr/Array_.php
@@ -27,4 +27,8 @@ class Array_ extends Expr
    public function getSubNodeNames() : array {
        return ['items'];
    }
+    
+    public function getType() : string {
+        return 'Expr_Array';
+    }
 }
--- a/lib/PhpParser/Node/Expr/Assign.php
+++ b/lib/PhpParser/Node/Expr/Assign.php
@@ -27,4 +27,8 @@ class Assign extends Expr
    public function getSubNodeNames() : array {
        return ['var', 'expr'];
    }
+    
+    public function getType() : string {
+        return 'Expr_Assign';
+    }
 }
--- a/lib/PhpParser/Node/Expr/AssignOp/BitwiseAnd.php
+++ b/lib/PhpParser/Node/Expr/AssignOp/BitwiseAnd.php
@@ -6,4 +6,7 @@ use PhpParser\Node\Expr\AssignOp;

 class BitwiseAnd extends AssignOp
 {
-}
+    public function getType() : string {
+        return 'Expr_AssignOp_BitwiseAnd';
+    }
+}
--- a/lib/PhpParser/Node/Expr/AssignOp/BitwiseOr.php
+++ b/lib/PhpParser/Node/Expr/AssignOp/BitwiseOr.php
@@ -6,4 +6,7 @@ use PhpParser\Node\Expr\AssignOp;

 class BitwiseOr extends AssignOp
 {
-}
+    public function getType() : string {
+        return 'Expr_AssignOp_BitwiseOr';
+    }
+}
--- a/lib/PhpParser/Node/Expr/AssignOp/BitwiseXor.php
+++ b/lib/PhpParser/Node/Expr/AssignOp/BitwiseXor.php
@@ -6,4 +6,7 @@ use PhpParser\Node\Expr\AssignOp;

 class BitwiseXor extends AssignOp
 {
-}
+    public function getType() : string {
+        return 'Expr_AssignOp_BitwiseXor';
+    }
+}
--- a/lib/PhpParser/Node/Expr/AssignOp/Concat.php
+++ b/lib/PhpParser/Node/Expr/AssignOp/Concat.php
@@ -6,4 +6,7 @@ use PhpParser\Node\Expr\AssignOp;

 class Concat extends AssignOp
 {
-}
+    public function getType() : string {
+        return 'Expr_AssignOp_Concat';
+    }
+}
--- a/lib/PhpParser/Node/Expr/AssignOp/Div.php
+++ b/lib/PhpParser/Node/Expr/AssignOp/Div.php
@@ -6,4 +6,7 @@ use PhpParser\Node\Expr\AssignOp;

 class Div extends AssignOp
 {
-}
+    public function getType() : string {
+        return 'Expr_AssignOp_Div';
+    }
+}
--- a/lib/PhpParser/Node/Expr/AssignOp/Minus.php
+++ b/lib/PhpParser/Node/Expr/AssignOp/Minus.php
@@ -6,4 +6,7 @@ use PhpParser\Node\Expr\AssignOp;

 class Minus extends AssignOp
 {
-}
+    public function getType() : string {
+        return 'Expr_AssignOp_Minus';
+    }
+}
--- a/lib/PhpParser/Node/Expr/AssignOp/Mod.php
+++ b/lib/PhpParser/Node/Expr/AssignOp/Mod.php
@@ -6,4 +6,7 @@ use PhpParser\Node\Expr\AssignOp;

 class Mod extends AssignOp
 {
-}
+    public function getType() : string {
+        return 'Expr_AssignOp_Mod';
+    }
+}
--- a/lib/PhpParser/Node/Expr/AssignOp/Mul.php
+++ b/lib/PhpParser/Node/Expr/AssignOp/Mul.php
@@ -6,4 +6,7 @@ use PhpParser\Node\Expr\AssignOp;

 class Mul extends AssignOp
 {
-}
+    public function getType() : string {
+        return 'Expr_AssignOp_Mul';
+    }
+}
--- a/lib/PhpParser/Node/Expr/AssignOp/Plus.php
+++ b/lib/PhpParser/Node/Expr/AssignOp/Plus.php
@@ -6,4 +6,7 @@ use PhpParser\Node\Expr\AssignOp;

 class Plus extends AssignOp
 {
-}
+    public function getType() : string {
+        return 'Expr_AssignOp_Plus';
+    }
+}
--- a/lib/PhpParser/Node/Expr/AssignOp/Pow.php
+++ b/lib/PhpParser/Node/Expr/AssignOp/Pow.php
@@ -6,4 +6,7 @@ use PhpParser\Node\Expr\AssignOp;

 class Pow extends AssignOp
 {
-}
+    public function getType() : string {
+        return 'Expr_AssignOp_Pow';
+    }
+}
--- a/lib/PhpParser/Node/Expr/AssignOp/ShiftLeft.php
+++ b/lib/PhpParser/Node/Expr/AssignOp/ShiftLeft.php
@@ -6,4 +6,7 @@ use PhpParser\Node\Expr\AssignOp;

 class ShiftLeft extends AssignOp
 {
-}
+    public function getType() : string {
+        return 'Expr_AssignOp_ShiftLeft';
+    }
+}
--- a/lib/PhpParser/Node/Expr/AssignOp/ShiftRight.php
+++ b/lib/PhpParser/Node/Expr/AssignOp/ShiftRight.php
@@ -6,4 +6,7 @@ use PhpParser\Node\Expr\AssignOp;

 class ShiftRight extends AssignOp
 {
-}
+    public function getType() : string {
+        return 'Expr_AssignOp_ShiftRight';
+    }
+}
--- a/lib/PhpParser/Node/Expr/AssignRef.php
+++ b/lib/PhpParser/Node/Expr/AssignRef.php
@@ -27,4 +27,8 @@ class AssignRef extends Expr
    public function getSubNodeNames() : array {
        return ['var', 'expr'];
    }
+    
+    public function getType() : string {
+        return 'Expr_AssignRef';
+    }
 }
--- a/lib/PhpParser/Node/Expr/BinaryOp.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp.php
@@ -12,7 +12,7 @@ abstract class BinaryOp extends Expr
    public $right;

    /**
-     * Constructs a bitwise and node.
+     * Constructs a binary operator node.
     *
     * @param Expr  $left       The left hand side expression
     * @param Expr  $right      The right hand side expression
--- a/lib/PhpParser/Node/Expr/BinaryOp/BitwiseAnd.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/BitwiseAnd.php
@@ -9,4 +9,8 @@ class BitwiseAnd extends BinaryOp
    public function getOperatorSigil() : string {
        return '&';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_BitwiseAnd';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/BitwiseOr.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/BitwiseOr.php
@@ -9,4 +9,8 @@ class BitwiseOr extends BinaryOp
    public function getOperatorSigil() : string {
        return '|';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_BitwiseOr';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/BitwiseXor.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/BitwiseXor.php
@@ -9,4 +9,8 @@ class BitwiseXor extends BinaryOp
    public function getOperatorSigil() : string {
        return '^';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_BitwiseXor';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/BooleanAnd.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/BooleanAnd.php
@@ -9,4 +9,8 @@ class BooleanAnd extends BinaryOp
    public function getOperatorSigil() : string {
        return '&&';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_BooleanAnd';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/BooleanOr.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/BooleanOr.php
@@ -9,4 +9,8 @@ class BooleanOr extends BinaryOp
    public function getOperatorSigil() : string {
        return '||';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_BooleanOr';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/Coalesce.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Coalesce.php
@@ -9,4 +9,8 @@ class Coalesce extends BinaryOp
    public function getOperatorSigil() : string {
        return '??';
    }
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Coalesce';
+    }
 }
--- a/lib/PhpParser/Node/Expr/BinaryOp/Concat.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Concat.php
@@ -9,4 +9,8 @@ class Concat extends BinaryOp
    public function getOperatorSigil() : string {
        return '.';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Concat';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/Div.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Div.php
@@ -9,4 +9,8 @@ class Div extends BinaryOp
    public function getOperatorSigil() : string {
        return '/';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Div';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/Equal.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Equal.php
@@ -9,4 +9,8 @@ class Equal extends BinaryOp
    public function getOperatorSigil() : string {
        return '==';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Equal';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/Greater.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Greater.php
@@ -9,4 +9,8 @@ class Greater extends BinaryOp
    public function getOperatorSigil() : string {
        return '>';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Greater';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/GreaterOrEqual.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/GreaterOrEqual.php
@@ -9,4 +9,8 @@ class GreaterOrEqual extends BinaryOp
    public function getOperatorSigil() : string {
        return '>=';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_GreaterOrEqual';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/Identical.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Identical.php
@@ -9,4 +9,8 @@ class Identical extends BinaryOp
    public function getOperatorSigil() : string {
        return '===';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Identical';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/LogicalAnd.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/LogicalAnd.php
@@ -9,4 +9,8 @@ class LogicalAnd extends BinaryOp
    public function getOperatorSigil() : string {
        return 'and';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_LogicalAnd';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/LogicalOr.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/LogicalOr.php
@@ -9,4 +9,8 @@ class LogicalOr extends BinaryOp
    public function getOperatorSigil() : string {
        return 'or';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_LogicalOr';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/LogicalXor.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/LogicalXor.php
@@ -9,4 +9,8 @@ class LogicalXor extends BinaryOp
    public function getOperatorSigil() : string {
        return 'xor';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_LogicalXor';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/Minus.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Minus.php
@@ -9,4 +9,8 @@ class Minus extends BinaryOp
    public function getOperatorSigil() : string {
        return '-';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Minus';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/Mod.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Mod.php
@@ -9,4 +9,8 @@ class Mod extends BinaryOp
    public function getOperatorSigil() : string {
        return '%';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Mod';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/Mul.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Mul.php
@@ -9,4 +9,8 @@ class Mul extends BinaryOp
    public function getOperatorSigil() : string {
        return '*';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Mul';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/NotEqual.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/NotEqual.php
@@ -9,4 +9,8 @@ class NotEqual extends BinaryOp
    public function getOperatorSigil() : string {
        return '!=';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_NotEqual';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/NotIdentical.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/NotIdentical.php
@@ -9,4 +9,8 @@ class NotIdentical extends BinaryOp
    public function getOperatorSigil() : string {
        return '!==';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_NotIdentical';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/Plus.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Plus.php
@@ -9,4 +9,8 @@ class Plus extends BinaryOp
    public function getOperatorSigil() : string {
        return '+';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Plus';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/Pow.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Pow.php
@@ -9,4 +9,8 @@ class Pow extends BinaryOp
    public function getOperatorSigil() : string {
        return '**';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Pow';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/ShiftLeft.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/ShiftLeft.php
@@ -9,4 +9,8 @@ class ShiftLeft extends BinaryOp
    public function getOperatorSigil() : string {
        return '<<';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_ShiftLeft';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/ShiftRight.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/ShiftRight.php
@@ -9,4 +9,8 @@ class ShiftRight extends BinaryOp
    public function getOperatorSigil() : string {
        return '>>';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_ShiftRight';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/Smaller.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Smaller.php
@@ -9,4 +9,8 @@ class Smaller extends BinaryOp
    public function getOperatorSigil() : string {
        return '<';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Smaller';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/SmallerOrEqual.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/SmallerOrEqual.php
@@ -9,4 +9,8 @@ class SmallerOrEqual extends BinaryOp
    public function getOperatorSigil() : string {
        return '<=';
    }
-}
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_SmallerOrEqual';
+    }
+}
--- a/lib/PhpParser/Node/Expr/BinaryOp/Spaceship.php
+++ b/lib/PhpParser/Node/Expr/BinaryOp/Spaceship.php
@@ -9,4 +9,8 @@ class Spaceship extends BinaryOp
    public function getOperatorSigil() : string {
        return '<=>';
    }
+    
+    public function getType() : string {
+        return 'Expr_BinaryOp_Spaceship';
+    }
 }
--- a/lib/PhpParser/Node/Expr/BitwiseNot.php
+++ b/lib/PhpParser/Node/Expr/BitwiseNot.php
@@ -23,4 +23,8 @@ class BitwiseNot extends Expr
    public function getSubNodeNames() : array {
        return ['expr'];
    }
+    
+    public function getType() : string {
+        return 'Expr_BitwiseNot';
+    }
 }
--- a/lib/PhpParser/Node/Expr/BooleanNot.php
+++ b/lib/PhpParser/Node/Expr/BooleanNot.php
@@ -23,4 +23,8 @@ class BooleanNot extends Expr
    public function getSubNodeNames() : array {
        return ['expr'];
    }
+    
+    public function getType() : string {
+        return 'Expr_BooleanNot';
+    }
 }
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Nikita Popov	bd088dc940	Release PHP-Parser 4.0.3	2018-07-15 19:25:16 +02:00
Nikita Popov	8b1c9c0409	Store comment at end of class in Nop statement Fixed #509.	2018-07-07 12:49:49 +02:00
openex27	df64d86cf4	Check for empty $append in safeAppend() Can happen with Nop statements.	2018-07-07 12:34:07 +02:00
Nikita Popov	aac539ef0a	Adjust test output Whoops, forgot to commit this part.	2018-07-07 12:25:01 +02:00
Nikita Popov	f967b867d5	Improve error recovery in arrays Similarly to missing semicolons, the error is not indicated in the AST. Fixes #512.	2018-07-07 12:24:06 +02:00
Gabriel Caruso	6bbdaf6c16	Remove flags from phpunit.xml that have default value and colorize (#510 )	2018-07-01 23:29:44 +02:00
Nikita Popov	35b8caf75e	Release PHP-Parser 4.0.2	2018-06-03 13:33:10 +02:00
Nikita Popov	6526ea2497	Throw when printin EncapsedStringPart This needs to go through something like Encapsed or ShellExec to determine quotation type. Explicitly throw an exception to avoid getting an undefined method error.	2018-06-03 13:31:00 +02:00
David Paz	3ce5e628a7	Fix binary operator doc block comment (#504 ) Remove reference to bitwise and in doc block.	2018-05-19 12:21:45 +02:00
Gabriel Caruso	ee870e3464	Fixes from PHPStan (#502 )	2018-05-19 11:12:24 +02:00
Gabriel Caruso	21d27527ed	Use dedicated assertNull assertion (#503 )	2018-05-19 11:12:07 +02:00
Nikita Popov	7b201b63d2	Error recovery for functions without body	2018-05-13 16:28:08 +02:00
Nikita Popov	01e85a26c6	Support recovery for param without variable We store an Expr\Error for the variable in this case.	2018-05-12 19:49:39 +02:00
Gabriel Caruso	e6452e8d15	Fix typo in UPGRADE-4.0 (#498 )	2018-05-05 23:45:25 +02:00
Gabriel Caruso	9202d87f53	Fix typos in UPGRADE-4.0 (#497 )	2018-05-01 22:19:29 +02:00
Nikita Popov	fa99c3fbfb	Recover from foreach without as	2018-04-28 22:31:45 +02:00
Loek van der Linde	2b0bd657bb	Update 2_Usage_of_basic_components.markdown (#494 )	2018-04-17 18:29:16 +03:00
Hans Ott	81b7be3ba6	Fix links in README.md (#493 )	2018-04-07 18:26:59 +03:00
Nikita Popov	6121001576	Remove unused ParserAbstract::$errors property Leftover from before ErrorHandler was introduced.	2018-03-30 21:45:52 +02:00
Nikita Popov	7208b1c7ac	Improve error recovery in classes (#492 )	2018-03-30 16:03:03 +02:00
Nikita Popov	e4a54fa90a	Release PHP-Parser 4.0.1	2018-03-25 19:35:16 +02:00
Nikita Popov	3125b54e5e	Link to composer/xdebug-handler	2018-03-25 19:34:45 +02:00
Nikita Popov	7f8ff1b9a4	Add support for list reference assignments RFC: https://wiki.php.net/rfc/list_reference_assignment	2018-03-10 16:48:20 +01:00
Nikita Popov	91a462ce76	PHP 7.3: Add support for trailing commas in calls RFC: https://wiki.php.net/rfc/trailing-comma-function-calls	2018-03-10 16:41:20 +01:00
Nikita Popov	610617fe93	Also add new() builder	2018-03-03 22:25:58 +01:00
Nikita Popov	ff2d85dc6b	Add constFetch() and classConstFetch() builders	2018-03-03 22:14:42 +01:00
Nikita Popov	b998d1e9b5	Add funcCall(), methodCall() and staticCall() builders	2018-03-03 15:40:51 +01:00
Nikita Popov	6aba7624ed	Add replacement sanity check in traverser	2018-03-03 13:22:36 +01:00
Nikita Popov	9c18e3db49	Release PHP-Parser 4.0.0	2018-02-28 21:39:30 +01:00
Nikita Popov	ae52aadb43	Fix merge leftovers in changelog	2018-02-28 21:37:11 +01:00
Nikita Popov	9cea94000a	Merge branch '3.x' Conflicts: CHANGELOG.md lib/PhpParser/NodeAbstract.php	2018-02-28 21:32:04 +01:00
Nikita Popov	bb87e28e7d	Release PHP-Parser 3.1.5	2018-02-28 21:30:58 +01:00
Nikita Popov	7484acb88b	Enable syntax highlighting for one code block	2018-02-28 21:27:29 +01:00
Nikita Popov	bc5ba47b28	Add links to component docs	2018-02-28 21:14:04 +01:00
Nikita Popov	b9996315a6	Add more extensive docs for node visitors Also document NodeFinder.	2018-02-28 21:00:42 +01:00
Ryan Weaver	de3470190c	Proofreading the docs - very minor changes!	2018-02-28 18:15:02 +01:00
Théo FIDRY	1c3eabb000	Replace string by class call (#477 ) For better PHP-Scoper compatibility	2018-02-23 22:44:40 +01:00
Nikita Popov	8d1e86b47f	Move node dumper docs into basic usage Also mentioned php-parse here.	2018-02-08 17:17:32 +01:00
Nikita Popov	ff10cc9d08	Move JSON representation into component documentation Also add -j flag to php-parse script to get a JSON dump. Also drop obsolete flag for XML dumping.	2018-02-08 16:36:04 +01:00
Gabriel Caruso	14454326e9	Fix misspellings	2018-02-06 14:47:39 +01:00
Gabriel Caruso	3a45c1a121	Support PHPUnit 7	2018-02-02 11:52:56 +01:00
Nikita Popov	ad9c42b66a	Merge branch '3.x' Conflicts: lib/PhpParser/Parser/Php5.php lib/PhpParser/Parser/Php7.php	2018-01-30 23:07:11 +01:00
Nikita Popov	08215e7646	Fix duplicate switch comment assignment Fixes #469.	2018-01-30 23:06:20 +01:00
Nikita Popov	c18bb27723	Release PHP-Parser 4.0 Beta 1	2018-01-27 19:06:36 +01:00
Nikita Popov	dd0adcc96c	Move code gen docs to components and improve Mention non-fluent helper methods.	2018-01-27 18:56:21 +01:00
Nikita Popov	e4505de346	Move FAQ into component documentation	2018-01-27 18:40:22 +01:00
Nikita Popov	a513ccabb7	Improve constant evaluation and add docs Split into evaluateDirectly() and evaluateSilently(), to be able to treat errors more gracefully. Add documentation for constant evaluation.	2018-01-27 17:47:45 +01:00
Nikita Popov	d817818b5d	Move TokenStream into Internal namespace	2018-01-27 13:40:20 +01:00
Nikita Popov	6a273c9fbd	Remove Autoloader class	2018-01-25 23:13:53 +01:00
Nikita Popov	c2d3ecad35	Merge branch '3.x' Conflicts: CHANGELOG.md	2018-01-25 22:32:25 +01:00
Nikita Popov	e57b3a0978	Release PHP-Parser 3.1.4	2018-01-25 22:31:33 +01:00
Nikita Popov	1cdb280a30	Merge branch '3.x'	2018-01-25 22:28:08 +01:00
Nikita Popov	d01fafcb40	Handle +(++$x) and -(--$x) as well	2018-01-25 22:27:37 +01:00
Miguel Piedrafita	67df02c844	Update license year	2018-01-25 22:23:06 +01:00
Nikita Popov	b85b6b3519	Merge branch '3.x' Conflicts: lib/PhpParser/PrettyPrinter/Standard.php	2018-01-25 22:18:32 +01:00
Nikita Popov	94c715d97e	Fix pretty printing of -(-$x) and +(+$x) Fixes #459.	2018-01-25 22:17:35 +01:00
Nikita Popov	4dacbb8d39	FPPP: Fix indentation on list insertion Use indentation of last list element, instead of indentation before the insertion point. Fixes #466.	2018-01-25 22:08:40 +01:00
Gabriel Caruso	aa685e711a	Bump to PHP 7.2 in documentation	2018-01-14 22:10:37 +01:00
Gabriel Caruso	edafeb85c4	[CS] Order uses A -> Z	2018-01-13 16:08:27 +01:00
Gabriel Caruso	68d07c4662	[CS] New line in the end of file	2018-01-13 16:08:26 +01:00
Gabriel Caruso	8fae99aafe	[CS] Remove spaces	2018-01-13 16:08:25 +01:00
Nikita Popov	c7ada124d0	[CS] Use ::class notation instead of string Conflicts: test/PhpParser/ParserFactoryTest.php test/PhpParser/ParserTest.php	2018-01-13 16:08:17 +01:00
Gabriel Caruso	f6617e6d25	[CS] Space after ternary operator	2018-01-13 16:04:00 +01:00
Gabriel Caruso	2499534729	[CS] Whitespace before return type	2018-01-13 16:03:59 +01:00
Gabriel Caruso	e0a2043089	[CS] Space before casting	2018-01-13 16:03:57 +01:00
Gabriel Caruso	e6e52abae7	[CS] Trim whitespaces	2018-01-13 16:03:56 +01:00
Gabriel Caruso	7f72c84122	[CS] Open class brackets in new line	2018-01-13 16:03:55 +01:00
Gabriel Caruso	fc8ac71e76	[CS] Trim whitespaces inside arrays	2018-01-13 16:03:54 +01:00
Gabriel Caruso	a8968caa5b	[CS] Remove extra lines	2018-01-13 16:03:53 +01:00
Nikita Popov	5285df8f22	[CS] Use elseif instead of else if Conflicts: lib/PhpParser/TokenStream.php	2018-01-13 16:03:36 +01:00
Gabriel Caruso	4366aa2fb0	[CS] Use __DIR__ instead of dirname(__FILE__)	2018-01-13 16:02:14 +01:00
Gabriel Caruso	bf7d811cda	Add methods visibility (#464 ) * [PSR-2] Visibility before static * [PSR-2] Declare method Visibility	2018-01-10 19:07:41 +01:00
Gabriel Caruso	248b29ecf6	Add public visibility to getType method (#463 )	2018-01-10 18:57:48 +01:00
Gabriel Caruso	bcb45d31eb	Trailing whitespaces (#461 ) Signed-off-by: Gabriel Caruso <carusogabriel34@gmail.com>	2018-01-08 11:10:03 +01:00
Gabriel Caruso	3bc31488ce	Combine issets (#460 )	2018-01-04 13:36:01 +01:00
Nikita Popov	92b39e3d1f	Fix nNextFreeElement for arrays with trailing comma Ugh.	2017-12-26 21:17:36 +01:00
Nikita Popov	1c7fd314d1	FPPP: Add heuristic for multi-line lists	2017-12-26 21:14:36 +01:00
Nikita Popov	fb8175567e	Simplify delayed add code $insertStr always stays the same, so no reason to store it separately.	2017-12-26 17:53:36 +01:00
Nikita Popov	63abf9cb3f	Release PHP-Parser 4.0 Alpha 3	2017-12-26 17:29:20 +01:00
Tomáš Votruba	ceb4932ca8	Clean merge leftover in changelog (#456 )	2017-12-26 17:25:14 +01:00
Nikita Popov	aa289c9694	Merge branch '3.x' Conflicts: CHANGELOG.md	2017-12-26 15:44:25 +01:00
Nikita Popov	579f4ce846	Release PHP-Parser 3.1.3	2017-12-26 15:43:21 +01:00
Nikita Popov	8d3cb5f57b	FPPP: Fallback if we must insert a block	2017-12-26 15:41:38 +01:00
Nikita Popov	de82a40d04	FPPP: Add broken InlineHTML test cases	2017-12-26 15:08:30 +01:00
Nikita Popov	a86151f24f	FPPP: Fix fallback for inline HTML	2017-12-26 15:08:29 +01:00
Gabriel Caruso	e6e8791848	Missing # in method description	2017-12-25 14:28:33 +01:00
Gabriel Caruso	83b958763f	Refactoring tests	2017-12-15 21:42:34 +01:00
Gabriel Caruso	4dbb02c57b	Use Null Coalesce Operator	2017-12-15 21:41:41 +01:00
Nikita Popov	4fcdac40d1	FPPP: Fix insertion of multiple elems at start	2017-12-02 15:10:15 +01:00
Nikita Popov	04feb90d79	Rename abc1.test to basic.test And split off fixup.test.	2017-12-01 23:15:50 +01:00
Nikita Popov	dc3ace55c3	FPPP: Support insert at start of list node (#446 )	2017-12-01 22:09:51 +01:00
Nikita Popov	e5453f0d46	Extract pSingleQuotedString as an extension point And add some more string formatting tests.	2017-12-01 18:31:21 +01:00
Nikita Popov	b507fa43da	Ensure names are not empty	2017-12-01 18:13:55 +01:00
Nikita Popov	336a49b428	FPPP: Fix comment indentation (#443 )	2017-11-13 13:27:27 +01:00
Nikita Popov	fa174b093f	Merge branch '3.x'	2017-11-13 01:15:38 +01:00
Nikita Popov	94ca9a7ab9	Use Tokens::class in lexer Ref #441.	2017-11-13 01:14:55 +01:00
Nikita Popov	0bb74e03aa	Drop two more getType() usages in builders	2017-11-13 00:24:01 +01:00
Nikita Popov	8d3f48ab75	Switch some auxiliary pretty printer tables away from getType() Instead use class names via ::class.	2017-11-13 00:18:44 +01:00
Nikita Popov	1c11626f0a	Add explicit getType() methods Rather than automatically deriving getType() from the class name.	2017-11-12 21:27:14 +01:00
Nikita Popov	05e2cd287e	Merge branch '3.x' Conflicts: lib/PhpParser/NodeAbstract.php	2017-11-12 21:12:27 +01:00
Maks Rafalko	bac91b426e	Correctly determine Type of Node when PHP-Parser's namespaces are prefixed Hi there, I'm working on mutation testing framework ([Infection](https://github.com/infection/infection/)) that is distributed as a PHAR. One of this goal is to run target project's test suite against mutated code. Since we use reflection and load project's autoloader, we want to avoid potential conflicts between vendor files of Infection itself and the target project. To avoid this issue, there is a project calld [PHP-Scoper](https://github.com/humbug/php-scoper). What it does is it prefixes all the namespaces of the library (including vendor folder) with some character(s), for example namespace `Infection\Mutator\PublicVisibility` is transformed to `ScoperAbc123\Infection\Mutant\PublicVisibility`. But since it also prefixes vendor folder, PHP-Parser's classes are prefixed as well and `NodeAbstract::getType()` after this prefixing works incorrectly. There is a hardcoded number `15` which means to remove `'PhpParser\Node'` (length=15) substring from the FQCN. Code: ```php // PHPParser\Node\Stmt\Declare_ -> Stmt_Declare return strtr(substr(rtrim(get_class($this), '_'), 15), '\\', '_'); ``` What I suggest is a little be more dynamic solution, to correctly extract class name (type) from the *prefixed* FQCL: `ScoperAbc123\PHPParser\Node\Stmt\Declare_` -> `Stmt_Declare`	2017-11-12 21:11:41 +01:00
Nikita Popov	a75164c77e	Rename YYNLSTATES to numNonLeafStates	2017-11-12 16:09:00 +01:00
Nikita Popov	c59e75f873	Clear parser state directly after parsing I don't think this makes any difference in practical scenarios, but it makes memory usage analysis simpler.	2017-11-11 16:54:52 +01:00
Nikita Popov	4392a7b164	Fix PHP5 static call fixup Variable nodes directly store the variable name as a string, they don't use VarLikeIdentifier. So remove this wrapper if it exists.	2017-11-11 12:23:14 +01:00