mirror of
https://github.com/danog/PHP-Parser.git
synced 2024-11-27 04:14:44 +01:00
224 lines
11 KiB
Markdown
224 lines
11 KiB
Markdown
Version 1.3.0-dev
|
|
-----------------
|
|
|
|
### Added
|
|
|
|
* Errors can now store the attributes of the node/token where the error occurred. Previously only the start line was
|
|
stored.
|
|
* If file positions are enabled in the lexer, errors can now provide column information if it is available.
|
|
TODO/link
|
|
* The parser now provides an experimental error recovery mode, which can be enabled by disabling the `throwOnError`
|
|
parser option. In this mode the parser will try to construct a partial AST even if the code is not valid PHP.
|
|
TODO/link
|
|
* Added support for PHP 7 `yield from` expression. It is represented by `Expr\YieldFrom`.
|
|
* Added support for PHP 7 anonymous classes. These are represented by ordinary `Stmt\Class_` nodes with the name set to
|
|
`null`. Furthermore this implies that `Expr\New_` can now contain a `Stmt\Class_` in its `class` subnode.
|
|
|
|
|
|
### Fixed
|
|
|
|
* Fixed registration of PHP 7 aliases, for the case where the old name was used before the new name.
|
|
* Fixed handling of precedence when pretty-printing `print` expressions.
|
|
* Checks for special class names like `self` are now case-insensitive.
|
|
|
|
Version 1.2.2 (2015-04-03)
|
|
--------------------------
|
|
|
|
* The `NameResolver` now resolves parameter type hints when entering the function/method/closure node. As such other
|
|
visitors running after it will be able to make use of the resolved names at that point already.
|
|
* The autoloader no longer sets the `unserialize_callback_func` ini option on registration - this is not necessary and
|
|
may cause issues when running PhpUnit tests with process isolation.
|
|
|
|
Version 1.2.1 (2015-03-24)
|
|
--------------------------
|
|
|
|
* Fixed registration of the aliases introduced in 1.2.0. Previously the old class names could not be used in
|
|
`instanceof` checks under some circumstances.
|
|
|
|
Version 1.2.0 (2015-03-22)
|
|
--------------------------
|
|
|
|
### Changed
|
|
|
|
* To ensure compatibility with PHP 7, the following node classes have been renamed:
|
|
|
|
OLD => NEW
|
|
PhpParser\Node\Expr\Cast\Bool => PhpParser\Node\Expr\Cast\Bool_
|
|
PhpParser\Node\Expr\Cast\Int => PhpParser\Node\Expr\Cast\Int_
|
|
PhpParser\Node\Expr\Cast\Object => PhpParser\Node\Expr\Cast\Object_
|
|
PhpParser\Node\Expr\Cast\String => PhpParser\Node\Expr\Cast\String_
|
|
PhpParser\Node\Scalar\String => PhpParser\Node\Scalar\String_
|
|
|
|
**The previous class names are still supported as aliases.** However it is strongly encouraged to use the new names
|
|
in order to make your code compatible with PHP 7.
|
|
|
|
* Subnodes are now stored using real properties instead of an array. This improves performance and memory usage of the
|
|
initial parse and subsequent node tree operations. The `NodeAbstract` class still supports the old way of specifying
|
|
subnodes, however this is *deprecated*. In any case properties that are assigned to a node after creation will no
|
|
longer be considered as subnodes.
|
|
|
|
* Methods and property declarations will no longer set the `Stmt\Class_::MODIFIER_PUBLIC` flag if no visibility is
|
|
explicitly given. However the `isPublic()` method will continue to return true. This allows you to distinguish whether
|
|
a method/property is explicitly or implicitly public and control the pretty printer output more precisely.
|
|
|
|
* The `Stmt\Class_`, `Stmt\Interface_` and `Stmt\Trait_` nodes now inherit from `Stmt\ClassLike`, which provides a
|
|
`getMethods()` method. Previously this method was only available on `Stmt\Class_`.
|
|
|
|
* Support including the `bootstrap.php` file multiple times.
|
|
|
|
* Make documentation and tests part of the release tarball again.
|
|
|
|
* Improve support for HHVM and PHP 7.
|
|
|
|
### Added
|
|
|
|
* Added support for PHP 7 return type declarations. This adds an additional `returnType` subnode to `Stmt\Function_`,
|
|
`Stmt\ClassMethod` and `Expr\Closure`.
|
|
|
|
* Added support for the PHP 7 null coalesce operator `??`. The operator is represented by `Expr\BinaryOp\Coalesce`.
|
|
|
|
* Added support for the PHP 7 spaceship operator `<=>`. The operator is represented by `Expr\BinaryOp\Spaceship`.
|
|
|
|
* Added use builder.
|
|
|
|
* Added global namespace support to the namespace builder.
|
|
|
|
* Added a constructor flag to `NodeTraverser`, which disables cloning of nodes.
|
|
|
|
Version 1.1.0 (2015-01-18)
|
|
--------------------------
|
|
|
|
* Methods that do not specify an explicit visibility (e.g. `function method()`) will now have the `MODIFIER_PUBLIC`
|
|
flag set. This also means that their `isPublic()` method will return true.
|
|
|
|
* Declaring a property as abstract or final is now an error.
|
|
|
|
* The `Lexer` and `Lexer\Emulative` classes now accept an `$options` array in their constructors. Currently only the
|
|
`usedAttributes` option is supported, which determines which attributes will be added to AST nodes. In particular
|
|
it is now possible to add information on the token and file positions corresponding to a node. For more details see
|
|
the [Lexer component](https://github.com/nikic/PHP-Parser/blob/master/doc/component/Lexer.markdown) documentation.
|
|
|
|
* Node visitors can now return `NodeTraverser::DONT_TRAVERSE_CHILDREN` from `enterNode()` in order to skip all children
|
|
of the current node, for all visitors.
|
|
|
|
* Added builders for traits and namespaces.
|
|
|
|
* The class, interface, trait, function, method and property builders now support adding doc comments using the
|
|
`setDocComment()` method.
|
|
|
|
* Added support for fully-qualified and namespace-relative names in builders. No longer allow use of name component
|
|
arrays.
|
|
|
|
* Do not add documentation and tests to distribution archive files.
|
|
|
|
Version 1.0.2 (2014-11-04)
|
|
--------------------------
|
|
|
|
* The `NameResolver` visitor now also resolves names in trait adaptations (aliases and precedence declarations).
|
|
|
|
* Remove stray whitespace when pretty-printing trait adaptations that only change visibility.
|
|
|
|
Version 1.0.1 (2014-10-14)
|
|
--------------------------
|
|
|
|
* Disallow `new` expressions without a class name. Previously `new;` was accidentally considered to be valid code.
|
|
|
|
* Support T_ONUMBER token used by HHVM.
|
|
|
|
* Add ability to directly pass code to the `php-parse.php` script.
|
|
|
|
* Prevent truncation of `var_dump()` output in the `php-parse.php` script if XDebug is used.
|
|
|
|
Version 1.0.0 (2014-09-12)
|
|
--------------------------
|
|
|
|
* [BC] Removed deprecated `Template` and `TemplateLoader` classes.
|
|
|
|
* Fixed XML unserializer to properly work with new namespaced node names.
|
|
|
|
Version 1.0.0-beta2 (2014-08-31)
|
|
--------------------------------
|
|
|
|
* [PHP 5.6] Updated support for constant scalar expressions to comply with latest changes. This means that arrays
|
|
and array dimension fetches are now supported as well.
|
|
|
|
* [PHP 5.6] Direct array dereferencing of constants is supported now, i.e. both `FOO[0]` and `Foo::BAR[0]` are valid
|
|
now.
|
|
|
|
* Fixed handling of special class names (`self`, `parent` and `static`) in the name resolver to be case insensitive.
|
|
Additionally the name resolver now enforces that special class names are only used as unqualified names, e.g. `\self`
|
|
is considered invalid.
|
|
|
|
* The case of references to the `static` class name is now preserved. Previously `static` was always lowercased,
|
|
regardless of the case used in the source code.
|
|
|
|
* The autoloader now only requires a file if it exists. This allows usages like
|
|
`class_exists('PhpParser\NotExistingClass')`.
|
|
|
|
* Added experimental `bin/php-parse.php` script, which is intended to help exploring and debugging the node tree.
|
|
|
|
* Separated the parser implemention (in `lib/PhpParser/ParserAbstract.php`) and the generated data (in
|
|
`lib/PhpParser/Parser.php`). Furthermore the parser now uses meaningful variable names and contains comments
|
|
explaining their usage.
|
|
|
|
Version 1.0.0-beta1 (2014-03-27)
|
|
--------------------------------
|
|
|
|
* [BC] PHP-Parser now requires PHP 5.3 or newer to run. It is however still possible to *parse* PHP 5.2 source code,
|
|
while running on a newer version.
|
|
|
|
* [BC] The library has been moved to use namespaces with the `PhpParser` vendor prefix. However, the old names using
|
|
underscores are still available as aliases, as such most code should continue running on the new version without
|
|
further changes.
|
|
|
|
However, code performing dispatch operations on `Node::getType()` may be affected by some of the name changes. For
|
|
example a `+` node will now return type `Expr_BinaryOp_Plus` instead of `Expr_Plus`. In particular this may affect
|
|
custom pretty printers.
|
|
|
|
Due to conflicts with reserved keywords, some class names now end with an underscore, e.g. `PHPParser_Node_Stmt_Class`
|
|
is now `PhpParser\Node\Stmt\Class_`. (But as usual, the old name is still available)
|
|
|
|
* [PHP 5.6] Added support for the power operator `**` (node `Expr\BinaryOp\Pow`) and the compound power assignment
|
|
operator `**=` (node `Expr\AssignOp\Pow`).
|
|
|
|
* [PHP 5.6] Added support for variadic functions: `Param` nodes now have `variadic` as a boolean subnode.
|
|
|
|
* [PHP 5.6] Added support for argument unpacking: `Arg` nodes now have `unpack` as a boolean subnode.
|
|
|
|
* [PHP 5.6] Added support for aliasing of functions and constants. `Stmt\Use_` nodes now have an integral `type`
|
|
subnode, which is one of `Stmt\Use_::TYPE_NORMAL` (`use`), `Stmt\Use_::TYPE_FUNCTION` (`use function`) or
|
|
`Stmt\Use_::TYPE_CONSTANT` (`use const`).
|
|
|
|
The `NameResolver` now also supports resolution of such aliases.
|
|
|
|
* [PHP 5.6] Added support for constant scalar expressions. This means that certain expressions are now allowed as the
|
|
initializer for constants, properties, parameters, static variables, etc.
|
|
|
|
* [BC] Improved pretty printing of empty statements lists, which are now printed as `{\n}` instead of `{\n \n}`.
|
|
This changes the behavior of the protected `PrettyPrinterAbstract::pStmts()` method, so custom pretty printing code
|
|
making use it of may need to be adjusted.
|
|
|
|
* Changed the order of some subnodes to be consistent with their order in the sour code. For example `Stmt\If->cond`
|
|
will now appear before `Stmt\If->stmts` etc.
|
|
|
|
* Added `Scalar\MagicConstant->getName()`, which returns the name of the magic constant (e.g. `__CLASS__`).
|
|
|
|
**The following changes are also included in 0.9.5**:
|
|
|
|
* [BC] Deprecated `PHPParser_Template` and `PHPParser_TemplateLoader`. This functionality does not belong in the main project
|
|
and - as far as I know - nobody is using it.
|
|
|
|
* Add `NodeTraverser::removeVisitor()` method, which removes a visitor from the node traverser. This also modifies the
|
|
corresponding `NodeTraverserInterface`.
|
|
|
|
* Fix alias resolution in `NameResolver`: Class names are now correctly handled as case-insensitive.
|
|
|
|
* The undefined variable error, which is used to the lexer to reset the error state, will no longer interfere with
|
|
custom error handlers.
|
|
|
|
---
|
|
|
|
**This changelog only includes changes from the 1.0 series. For older changes see the [0.9 series changelog][1].**
|
|
|
|
[1]: https://github.com/nikic/PHP-Parser/blob/0.9/CHANGELOG.md
|