Chris@17: Version 4.2.2-dev Chris@0: ----------------- Chris@0: Chris@0: Nothing yet. Chris@0: Chris@17: Version 4.2.1 (2019-02-16) Chris@17: -------------------------- Chris@17: Chris@17: ### Added Chris@17: Chris@17: * [PHP 7.4] Add support for `??=` operator through a new `AssignOp\Coalesce` node. (#575) Chris@17: Chris@17: Version 4.2.0 (2019-01-12) Chris@17: -------------------------- Chris@17: Chris@17: ### Added Chris@17: Chris@17: * [PHP 7.4] Add support for typed properties through a new `type` subnode of `Stmt\Property`. Chris@17: Additionally `Builder\Property` now has a `setType()` method. (#567) Chris@17: * Add `kind` attribute to `Cast\Double_`, which allows to distinguish between `(float)`, Chris@17: `(double)` and `(real)`. The form of the cast will be preserved by the pretty printer. (#565) Chris@17: Chris@17: ### Fixed Chris@17: Chris@17: * Remove assertion when pretty printing anonymous class with a name (#554). Chris@17: Chris@17: Version 4.1.1 (2018-12-26) Chris@17: -------------------------- Chris@17: Chris@17: ### Fixed Chris@17: Chris@17: * Fix "undefined offset" notice when parsing specific malformed code (#551). Chris@17: Chris@17: ### Added Chris@17: Chris@17: * Support error recovery for missing return type (`function foo() : {}`) (#544). Chris@17: Chris@17: Version 4.1.0 (2018-10-10) Chris@17: -------------------------- Chris@17: Chris@17: ### Added Chris@17: Chris@17: * Added support for PHP 7.3 flexible heredoc/nowdoc strings, completing support for PHP 7.3. There Chris@17: are two caveats for this feature: Chris@17: * In some rare, pathological cases flexible heredoc/nowdoc strings change the interpretation of Chris@17: existing doc strings. PHP-Parser will now use the new interpretation. Chris@17: * Flexible heredoc/nowdoc strings require special support from the lexer. Because this is not Chris@17: available on PHP versions before 7.3, support has to be emulated. This emulation is not perfect Chris@17: and some cases which we do not expect to occur in practice (such as flexible doc strings being Chris@17: nested within each other through abuse of variable-variable interpolation syntax) may not be Chris@17: recognized correctly. Chris@17: * Added `DONT_TRAVERSE_CURRENT_AND_CHILDREN` to `NodeTraverser` to skip both traversal of child Chris@17: nodes, and prevent subsequent visitors from visiting the current node. Chris@17: Chris@17: Version 4.0.4 (2018-09-18) Chris@17: -------------------------- Chris@17: Chris@17: ### Added Chris@17: Chris@17: * The following methods have been added to `BuilderFactory`: Chris@17: * `useTrait()` (fluent builder) Chris@17: * `traitUseAdaptation()` (fluent builder) Chris@17: * `useFunction()` (fluent builder) Chris@17: * `useConst()` (fluent builder) Chris@17: * `var()` Chris@17: * `propertyFetch()` Chris@17: Chris@17: ### Deprecated Chris@17: Chris@17: * `Builder\Param::setTypeHint()` has been deprecated in favor of the newly introduced Chris@17: `Builder\Param::setType()`. Chris@17: Chris@17: Version 4.0.3 (2018-07-15) Chris@17: -------------------------- Chris@17: Chris@17: ### Fixed Chris@17: Chris@17: * Fixed possible undefined offset notice in formatting-preserving printer. (#513) Chris@17: Chris@17: ### Added Chris@17: Chris@17: * Improved error recovery inside arrays. Chris@17: * Preserve trailing comment inside classes. **Note:** This change is possibly BC breaking if your Chris@17: code validates that classes can only contain certain statement types. After this change, classes Chris@17: can also contain Nop statements, while this was not previously possible. (#509) Chris@17: Chris@16: Version 4.0.2 (2018-06-03) Chris@16: -------------------------- Chris@16: Chris@16: ### Added Chris@16: Chris@16: * Improved error recovery inside classes. Chris@16: * Support error recovery for `foreach` without `as`. Chris@16: * Support error recovery for parameters without variable (`function (Type ) {}`). Chris@16: * Support error recovery for functions without body (`function ($foo)`). Chris@16: Chris@13: Version 4.0.1 (2018-03-25) Chris@13: -------------------------- Chris@13: Chris@13: ### Added Chris@13: Chris@13: * [PHP 7.3] Added support for trailing commas in function calls. Chris@13: * [PHP 7.3] Added support for by-reference array destructuring. Chris@13: * Added checks to node traverser to prevent replacing a statement with an expression or vice versa. Chris@13: This should prevent common mistakes in the implementation of node visitors. Chris@13: * Added the following methods to `BuilderFactory`, to simplify creation of expressions: Chris@13: * `funcCall()` Chris@13: * `methodCall()` Chris@13: * `staticCall()` Chris@13: * `new()` Chris@13: * `constFetch()` Chris@13: * `classConstFetch()` Chris@13: Chris@13: Version 4.0.0 (2018-02-28) Chris@13: -------------------------- Chris@13: Chris@13: * No significant code changes since the beta 1 release. Chris@13: Chris@13: Version 4.0.0-beta1 (2018-01-27) Chris@13: -------------------------------- Chris@13: Chris@13: ### Fixed Chris@13: Chris@13: * In formatting-preserving pretty printer: Fixed indentation when inserting into lists. (#466) Chris@13: Chris@13: ### Added Chris@13: Chris@13: * In formatting-preserving pretty printer: Improved formatting of elements inserted into multi-line Chris@13: arrays. Chris@13: Chris@13: ### Removed Chris@13: Chris@13: * The `Autoloader` class has been removed. It is now required to use the Composer autoloader. Chris@13: Chris@13: Version 4.0.0-alpha3 (2017-12-26) Chris@13: --------------------------------- Chris@13: Chris@13: ### Fixed Chris@13: Chris@13: * In the formatting-preserving pretty printer: Chris@13: * Fixed comment indentation. Chris@13: * Fixed handling of inline HTML in the fallback case. Chris@13: * Fixed insertion into list nodes that require creation of a code block. Chris@13: Chris@13: ### Added Chris@13: Chris@13: * Added support for inserting at the start of list nodes in formatting-preserving pretty printer. Chris@13: Chris@13: Version 4.0.0-alpha2 (2017-11-10) Chris@13: --------------------------------- Chris@13: Chris@13: ### Added Chris@13: Chris@13: * In the formatting-preserving pretty printer: Chris@13: * Added support for changing modifiers. Chris@13: * Added support for anonymous classes. Chris@13: * Added support for removing from list nodes. Chris@13: * Improved support for changing comments. Chris@13: * Added start token offsets to comments. Chris@13: Chris@13: Version 4.0.0-alpha1 (2017-10-18) Chris@13: --------------------------------- Chris@13: Chris@13: ### Added Chris@13: Chris@13: * Added experimental support for format-preserving pretty-printing. In this mode formatting will be Chris@13: preserved for parts of the code which have not been modified. Chris@13: * Added `replaceNodes` option to `NameResolver`, defaulting to true. If this option is disabled, Chris@13: resolved names will be added as `resolvedName` attributes, instead of replacing the original Chris@13: names. Chris@13: * Added `NodeFinder` class, which can be used to find nodes based on a callback or class name. This Chris@13: is a utility to avoid custom node visitor implementations for simple search operations. Chris@13: * Added `ClassMethod::isMagic()` method. Chris@13: * Added `BuilderFactory` methods: `val()` method for creating an AST for a simple value, `concat()` Chris@13: for creating concatenation trees, `args()` for preparing function arguments. Chris@13: * Added `NameContext` class, which encapsulates the `NameResolver` logic independently of the actual Chris@13: AST traversal. This facilitates use in other context, such as class names in doc comments. Chris@13: Additionally it provides an API for getting the shortest representation of a name. Chris@13: * Added `Node::setAttributes()` method. Chris@13: * Added `JsonDecoder`. This allows conversion JSON back into an AST. Chris@13: * Added `Name` methods `toLowerString()` and `isSpecialClassName()`. Chris@13: * Added `Identifier` and `VarLikeIdentifier` nodes, which are used in place of simple strings in Chris@13: many places. Chris@13: * Added `getComments()`, `getStartLine()`, `getEndLine()`, `getStartTokenPos()`, `getEndTokenPos()`, Chris@13: `getStartFilePos()` and `getEndFilePos()` methods to `Node`. These provide a more obvious access Chris@13: point for the already existing attributes of the same name. Chris@13: * Added `ConstExprEvaluator` to evaluate constant expressions to PHP values. Chris@13: * Added `Expr\BinaryOp::getOperatorSigil()`, returning `+` for `Expr\BinaryOp\Plus`, etc. Chris@13: Chris@13: ### Changed Chris@13: Chris@13: * Many subnodes that previously held simple strings now use `Identifier` (or `VarLikeIdentifier`) Chris@13: nodes. Please see the UPGRADE-4.0 file for an exhaustive list of affected nodes and some notes on Chris@13: possible impact. Chris@13: * Expression statements (`expr;`) are now represented using a `Stmt\Expression` node. Previously Chris@13: these statements were directly represented as their constituent expression. Chris@13: * The `name` subnode of `Param` has been renamed to `var` and now contains a `Variable` rather than Chris@13: a plain string. Chris@13: * The `name` subnode of `StaticVar` has been renamed to `var` and now contains a `Variable` rather Chris@13: than a plain string. Chris@13: * The `var` subnode of `ClosureUse` now contains a `Variable` rather than a plain string. Chris@13: * The `var` subnode of `Catch` now contains a `Variable` rather than a plain string. Chris@13: * The `alias` subnode of `UseUse` is now `null` if no explicit alias is given. As such, Chris@13: `use Foo\Bar` and `use Foo\Bar as Bar` are now represented differently. The `getAlias()` method Chris@13: can be used to get the effective alias, even if it is not explicitly given. Chris@13: Chris@13: ### Removed Chris@13: Chris@13: * Support for running on PHP 5 and HHVM has been removed. You can however still parse code of old Chris@13: PHP versions (such as PHP 5.2), while running on PHP 7. Chris@13: * Removed `type` subnode on `Class`, `ClassMethod` and `Property` nodes. Use `flags` instead. Chris@13: * The `ClassConst::isStatic()` method has been removed. Constants cannot have a static modifier. Chris@13: * The `NodeTraverser` no longer accepts `false` as a return value from a `leaveNode()` method. Chris@13: `NodeTraverser::REMOVE_NODE` should be returned instead. Chris@13: * The `Node::setLine()` method has been removed. If you really need to, you can use `setAttribute()` Chris@13: instead. Chris@13: * The misspelled `Class_::VISIBILITY_MODIFER_MASK` constant has been dropped in favor of Chris@13: `Class_::VISIBILITY_MODIFIER_MASK`. Chris@13: * The XML serializer has been removed. As such, the classes `Serializer\XML`, and Chris@13: `Unserializer\XML`, as well as the interfaces `Serializer` and `Unserializer` no longer exist. Chris@13: * The `BuilderAbstract` class has been removed. It's functionality is moved into `BuilderHelpers`. Chris@13: However, this is an internal class and should not be used directly. Chris@13: Chris@13: Version 3.1.5 (2018-02-28) Chris@13: -------------------------- Chris@13: Chris@13: ### Fixed Chris@13: Chris@13: * Fixed duplicate comment assignment in switch statements. (#469) Chris@13: * Improve compatibility with PHP-Scoper. (#477) Chris@13: Chris@12: Version 3.1.4 (2018-01-25) Chris@12: -------------------------- Chris@12: Chris@12: ### Fixed Chris@12: Chris@12: * Fixed pretty printing of `-(-$x)` and `+(+$x)`. (#459) Chris@12: Chris@12: Version 3.1.3 (2017-12-26) Chris@12: -------------------------- Chris@12: Chris@12: ### Fixed Chris@12: Chris@12: * Improve compatibility with php-scoper, by supporting prefixed namespaces in Chris@12: `NodeAbstract::getType()`. Chris@12: Chris@0: Version 3.1.2 (2017-11-04) Chris@0: -------------------------- Chris@0: Chris@0: ### Fixed Chris@0: Chris@0: * Comments on empty blocks are now preserved on a `Stmt\Nop` node. (#382) Chris@0: Chris@0: ### Added Chris@0: Chris@0: * Added `kind` attribute for `Stmt\Namespace_` node, which is one of `KIND_SEMICOLON` or Chris@0: `KIND_BRACED`. (#417) Chris@0: * Added `setDocComment()` method to namespace builder. (#437) Chris@0: Chris@0: Version 3.1.1 (2017-09-02) Chris@0: -------------------------- Chris@0: Chris@0: ### Fixed Chris@0: Chris@0: * Fixed syntax error on comment after brace-style namespace declaration. (#412) Chris@0: * Added support for TraitUse statements in trait builder. (#413) Chris@0: Chris@0: Version 3.1.0 (2017-07-28) Chris@0: -------------------------- Chris@0: Chris@0: ### Added Chris@0: Chris@0: * [PHP 7.2] Added support for trailing comma in group use statements. Chris@0: * [PHP 7.2] Added support for `object` type. This means `object` types will now be represented as a Chris@0: builtin type (a simple `"object"` string), rather than a class `Name`. Chris@13: Chris@0: ### Fixed Chris@0: Chris@0: * Floating-point numbers are now printed correctly if the LC_NUMERIC locale uses a comma as decimal Chris@0: separator. Chris@0: Chris@0: ### Changed Chris@0: Chris@0: * `Name::$parts` is no longer deprecated. Chris@0: Chris@0: Version 3.0.6 (2017-06-28) Chris@0: -------------------------- Chris@0: Chris@0: ### Fixed Chris@0: Chris@0: * Fixed the spelling of `Class_::VISIBILITY_MODIFIER_MASK`. The previous spelling of Chris@0: `Class_::VISIBILITY_MODIFER_MASK` is preserved for backwards compatibility. Chris@0: * The pretty printing will now preserve comments inside array literals and function calls by Chris@0: printing the array items / function arguments on separate lines. Array literals and functions that Chris@0: do not contain comments are not affected. Chris@0: Chris@0: ### Added Chris@0: Chris@0: * Added `Builder\Param::makeVariadic()`. Chris@0: Chris@0: ### Deprecated Chris@0: Chris@0: * The `Node::setLine()` method has been deprecated. Chris@0: Chris@0: Version 3.0.5 (2017-03-05) Chris@0: -------------------------- Chris@0: Chris@0: ### Fixed Chris@0: Chris@0: * Name resolution of `NullableType`s is now performed earlier, so that a fully resolved signature is Chris@0: available when a function is entered. (#360) Chris@0: * `Error` nodes are now considered empty, while previously they extended until the token where the Chris@0: error occurred. This made some nodes larger than expected. (#359) Chris@0: * Fixed notices being thrown during error recovery in some situations. (#362) Chris@0: Chris@0: Version 3.0.4 (2017-02-10) Chris@0: -------------------------- Chris@0: Chris@0: ### Fixed Chris@0: Chris@0: * Fixed some extensibility issues in pretty printer (`pUseType()` is now public and `pPrec()` calls Chris@0: into `p()`, instead of directly dispatching to the type-specific printing method). Chris@0: * Fixed notice in `bin/php-parse` script. Chris@0: Chris@0: ### Added Chris@0: Chris@0: * Error recovery from missing semicolons is now supported in more cases. Chris@0: * Error recovery from trailing commas in positions where PHP does not support them is now supported. Chris@0: Chris@0: Version 3.0.3 (2017-02-03) Chris@0: -------------------------- Chris@0: Chris@0: ### Fixed Chris@0: Chris@0: * In `"$foo[0]"` the `0` is now parsed as an `LNumber` rather than `String`. (#325) Chris@0: * Ensure integers and floats are always pretty printed preserving semantics, even if the particular Chris@0: value can only be manually constructed. Chris@0: * Throw a `LogicException` when trying to pretty-print an `Error` node. Previously this resulted in Chris@0: an undefined method exception or fatal error. Chris@0: Chris@0: ### Added Chris@0: Chris@0: * [PHP 7.1] Added support for negative interpolated offsets: `"$foo[-1]"` Chris@0: * Added `preserveOriginalNames` option to `NameResolver`. If this option is enabled, an Chris@0: `originalName` attribute, containing the unresolved name, will be added to each resolved name. Chris@0: * Added `php-parse --with-positions` option, which dumps nodes with position information. Chris@0: Chris@0: ### Deprecated Chris@0: Chris@0: * The XML serializer has been deprecated. In particular, the classes `Serializer\XML`, Chris@0: `Unserializer\XML`, as well as the interfaces `Serializer` and `Unserializer` are deprecated. Chris@0: Chris@0: Version 3.0.2 (2016-12-06) Chris@0: -------------------------- Chris@0: Chris@0: ### Fixed Chris@0: Chris@0: * Fixed name resolution of nullable types. (#324) Chris@0: * Fixed pretty-printing of nullable types. Chris@0: Chris@0: Version 3.0.1 (2016-12-01) Chris@0: -------------------------- Chris@0: Chris@0: ### Fixed Chris@0: Chris@0: * Fixed handling of nested `list()`s: If the nested list was unkeyed, it was directly included in Chris@0: the list items. If it was keyed, it was wrapped in `ArrayItem`. Now nested `List_` nodes are Chris@0: always wrapped in `ArrayItem`s. (#321) Chris@0: Chris@0: Version 3.0.0 (2016-11-30) Chris@0: -------------------------- Chris@0: Chris@0: ### Added Chris@0: Chris@0: * Added support for dumping node positions in the NodeDumper through the `dumpPositions` option. Chris@0: * Added error recovery support for `$`, `new`, `Foo::`. Chris@0: Chris@0: Version 3.0.0-beta2 (2016-10-29) Chris@0: -------------------------------- Chris@0: Chris@0: This release primarily improves our support for error recovery. Chris@0: Chris@0: ### Added Chris@0: Chris@0: * Added `Node::setDocComment()` method. Chris@0: * Added `Error::getMessageWithColumnInfo()` method. Chris@0: * Added support for recovery from lexer errors. Chris@0: * Added support for recovering from "special" errors (i.e. non-syntax parse errors). Chris@0: * Added precise location information for lexer errors. Chris@0: * Added `ErrorHandler` interface, and `ErrorHandler\Throwing` and `ErrorHandler\Collecting` as Chris@0: specific implementations. These provide a general mechanism for handling error recovery. Chris@0: * Added optional `ErrorHandler` argument to `Parser::parse()`, `Lexer::startLexing()` and Chris@0: `NameResolver::__construct()`. Chris@0: * The `NameResolver` now adds a `namespacedName` attribute on name nodes that cannot be statically Chris@0: resolved (unqualified unaliased function or constant names in namespaces). Chris@13: Chris@0: ### Fixed Chris@0: Chris@0: * Fixed attribute assignment for `GroupUse` prefix and variables in interpolated strings. Chris@0: Chris@0: ### Changed Chris@0: Chris@0: * The constants on `NameTraverserInterface` have been moved into the `NameTraverser` class. Chris@0: * Due to the error handling changes, the `Parser` interface and `Lexer` API have changed. Chris@0: * The emulative lexer now directly postprocesses tokens, instead of using `~__EMU__~` sequences. Chris@0: This changes the protected API of the lexer. Chris@0: * The `Name::slice()` method now returns `null` for empty slices, previously `new Name([])` was Chris@0: used. `Name::concat()` now also supports concatenation with `null`. Chris@0: Chris@0: ### Removed Chris@0: Chris@0: * Removed `Name::append()` and `Name::prepend()`. These mutable methods have been superseded by Chris@0: the immutable `Name::concat()`. Chris@0: * Removed `Error::getRawLine()` and `Error::setRawLine()`. These methods have been superseded by Chris@0: `Error::getStartLine()` and `Error::setStartLine()`. Chris@0: * Removed support for node cloning in the `NodeTraverser`. Chris@0: * Removed `$separator` argument from `Name::toString()`. Chris@0: * Removed `throw_on_error` parser option and `Parser::getErrors()` method. Use the `ErrorHandler` Chris@0: mechanism instead. Chris@0: Chris@0: Version 3.0.0-beta1 (2016-09-16) Chris@0: -------------------------------- Chris@0: Chris@0: ### Added Chris@0: Chris@0: * [7.1] Function/method and parameter builders now support PHP 7.1 type hints (void, iterable and Chris@0: nullable types). Chris@0: * Nodes and Comments now implement `JsonSerializable`. The node kind is stored in a `nodeType` Chris@0: property. Chris@0: * The `InlineHTML` node now has an `hasLeadingNewline` attribute, that specifies whether the Chris@0: preceding closing tag contained a newline. The pretty printer honors this attribute. Chris@0: * Partial parsing of `$obj->` (with missing property name) is now supported in error recovery mode. Chris@0: * The error recovery mode is now exposed in the `php-parse` script through the `--with-recovery` Chris@0: or `-r` flags. Chris@0: Chris@0: The following changes are also part of PHP-Parser 2.1.1: Chris@0: Chris@0: * The PHP 7 parser will now generate a parse error for `$var =& new Obj` assignments. Chris@0: * Comments on free-standing code blocks will now be retained as comments on the first statement in Chris@0: the code block. Chris@0: Chris@0: Version 3.0.0-alpha1 (2016-07-25) Chris@0: --------------------------------- Chris@0: Chris@0: ### Added Chris@0: Chris@0: * [7.1] Added support for `void` and `iterable` types. These will now be represented as strings Chris@0: (instead of `Name` instances) similar to other builtin types. Chris@0: * [7.1] Added support for class constant visibility. The `ClassConst` node now has a `flags` subnode Chris@0: holding the visibility modifier, as well as `isPublic()`, `isProtected()` and `isPrivate()` Chris@0: methods. The constructor changed to accept the additional subnode. Chris@0: * [7.1] Added support for nullable types. These are represented using a new `NullableType` node Chris@0: with a single `type` subnode. Chris@0: * [7.1] Added support for short array destructuring syntax. This means that `Array` nodes may now Chris@0: appear as the left-hand-side of assignments and foreach value targets. Additionally the array Chris@0: items may now contain `null` values if elements are skipped. Chris@0: * [7.1] Added support for keys in list() destructuring. The `List` subnode `vars` has been renamed Chris@0: to `items` and now contains `ArrayItem`s instead of plain variables. Chris@0: * [7.1] Added support for multi-catch. The `Catch` subnode `type` has been renamed to `types` and Chris@0: is now an array of `Name`s. Chris@0: * `Name::slice()` now supports lengths and negative offsets. This brings it in line with Chris@0: `array_slice()` functionality. Chris@0: Chris@0: ### Changed Chris@0: Chris@0: Due to PHP 7.1 support additions described above, the node structure changed as follows: Chris@0: Chris@0: * `void` and `iterable` types are now stored as strings if the PHP 7 parser is used. Chris@0: * The `ClassConst` constructor changed to accept an additional `flags` subnode. Chris@0: * The `Array` subnode `items` may now contain `null` elements (destructuring). Chris@0: * The `List` subnode `vars` has been renamed to `items` and now contains `ArrayItem`s instead of Chris@0: plain variables. Chris@0: * The `Catch` subnode `type` has been renamed to `types` and is now an array of `Name`s. Chris@0: Chris@0: Additionally the following changes were made: Chris@0: Chris@0: * The `type` subnode on `Class`, `ClassMethod` and `Property` has been renamed to `flags`. The Chris@0: `type` subnode has retained for backwards compatibility and is populated to the same value as Chris@0: `flags`. However, writes to `type` will not update `flags`. Chris@0: * The `TryCatch` subnode `finallyStmts` has been replaced with a `finally` subnode that holds an Chris@0: explicit `Finally` node. This allows for more accurate attribute assignment. Chris@0: * The `Trait` constructor now has the same form as the `Class` and `Interface` constructors: It Chris@0: takes an array of subnodes. Unlike classes/interfaces, traits can only have a `stmts` subnode. Chris@0: * The `NodeDumper` now prints class/method/property/constant modifiers, as well as the include and Chris@0: use type in a textual representation, instead of only showing the number. Chris@13: * All methods on `PrettyPrinter\Standard` are now protected. Previously most of them were public. Chris@0: Chris@0: ### Removed Chris@0: Chris@0: * Removed support for running on PHP 5.4. It is however still possible to parse PHP 5.2-5.4 code Chris@0: while running on a newer version. Chris@0: * The deprecated `Comment::setLine()` and `Comment::setText()` methods have been removed. Chris@0: * The deprecated `Name::set()`, `Name::setFirst()` and `Name::setLast()` methods have been removed. Chris@0: Chris@0: Version 2.1.1 (2016-09-16) Chris@0: -------------------------- Chris@0: Chris@0: ### Changed Chris@0: Chris@0: * The pretty printer will now escape all control characters in the range `\x00-\x1F` inside double Chris@0: quoted strings. If no special escape sequence is available, an octal escape will be used. Chris@0: * The quality of the error recovery has been improved. In particular unterminated expressions should Chris@0: be handled more gracefully. Chris@0: * The PHP 7 parser will now generate a parse error for `$var =& new Obj` assignments. Chris@0: * Comments on free-standing code blocks will no be retained as comments on the first statement in Chris@0: the code block. Chris@0: Chris@0: Version 2.1.0 (2016-04-19) Chris@0: -------------------------- Chris@0: Chris@0: ### Fixed Chris@0: Chris@0: * Properly support `B""` strings (with uppercase `B`) in a number of places. Chris@0: * Fixed reformatting of indented parts in a certain non-standard comment style. Chris@0: Chris@0: ### Added Chris@0: Chris@0: * Added `dumpComments` option to node dumper, to enable dumping of comments associated with nodes. Chris@0: * Added `Stmt\Nop` node, that is used to collect comments located at the end of a block or at the Chris@0: end of a file (without a following node with which they could otherwise be associated). Chris@0: * Added `kind` attribute to `Expr\Exit` to distinguish between `exit` and `die`. Chris@0: * Added `kind` attribute to `Scalar\LNumber` to distinguish between decimal, binary, octal and Chris@0: hexadecimal numbers. Chris@13: * Added `kind` attribute to `Expr\Array` to distinguish between `array()` and `[]`. Chris@0: * Added `kind` attribute to `Scalar\String` and `Scalar\Encapsed` to distinguish between Chris@0: single-quoted, double-quoted, heredoc and nowdoc string. Chris@0: * Added `docLabel` attribute to `Scalar\String` and `Scalar\Encapsed`, if it is a heredoc or Chris@0: nowdoc string. Chris@0: * Added start file offset information to `Comment` nodes. Chris@0: * Added `setReturnType()` method to function and method builders. Chris@0: * Added `-h` and `--help` options to `php-parse` script. Chris@0: Chris@0: ### Changed Chris@0: Chris@0: * Invalid octal literals now throw a parse error in PHP 7 mode. Chris@0: * The pretty printer takes all the new attributes mentioned in the previous section into account. Chris@0: * The protected `AbstractPrettyPrinter::pComments()` method no longer returns a trailing newline. Chris@0: * The bundled autoloader supports library files being stored in a different directory than Chris@0: `PhpParser` for easier downstream distribution. Chris@0: Chris@0: ### Deprecated Chris@0: Chris@0: * The `Comment::setLine()` and `Comment::setText()` methods have been deprecated. Construct new Chris@0: objects instead. Chris@0: Chris@0: ### Removed Chris@0: Chris@0: * The internal (but public) method `Scalar\LNumber::parse()` has been removed. A non-internal Chris@0: `LNumber::fromString()` method has been added instead. Chris@0: Chris@0: Version 2.0.1 (2016-02-28) Chris@0: -------------------------- Chris@0: Chris@0: ### Fixed Chris@0: Chris@0: * `declare() {}` and `declare();` are not semantically equivalent and will now result in different Chris@0: ASTs. The format case will have an empty `stmts` array, while the latter will set `stmts` to Chris@0: `null`. Chris@0: * Magic constants are now supported as semi-reserved keywords. Chris@0: * A shebang line like `#!/usr/bin/env php` is now allowed at the start of a namespaced file. Chris@0: Previously this generated an exception. Chris@0: * The `prettyPrintFile()` method will not strip a trailing `?>` from the raw data that follows a Chris@0: `__halt_compiler()` statement. Chris@0: * The `prettyPrintFile()` method will not strip an opening `slice()` which takes a subslice of a name. Chris@0: Chris@0: ### Changed Chris@0: Chris@0: * `PhpParser\Parser` is now an interface, implemented by `Parser\Php5`, `Parser\Php7` and Chris@0: `Parser\Multiple`. The `Multiple` parser will try multiple parsers, until one succeeds. Chris@0: * Token constants are now defined on `PhpParser\Parser\Tokens` rather than `PhpParser\Parser`. Chris@0: * The `Name->set()`, `Name->append()`, `Name->prepend()` and `Name->setFirst()` methods are Chris@0: deprecated in favor of `Name::concat()` and `Name->slice()`. Chris@0: * The `NodeTraverser` no longer clones nodes by default. The old behavior can be restored by Chris@0: passing `true` to the constructor. Chris@0: * The constructor for `Scalar` nodes no longer has a default value. E.g. `new LNumber()` should now Chris@0: be written as `new LNumber(0)`. Chris@0: Chris@0: --- Chris@0: Chris@0: **This changelog only includes changes from the 2.0 series. For older changes see the Chris@0: [1.x series changelog](https://github.com/nikic/PHP-Parser/blob/1.x/CHANGELOG.md) and the Chris@13: [0.9 series changelog](https://github.com/nikic/PHP-Parser/blob/0.9/CHANGELOG.md).**