PHP-Parser 0.9.5

This is the last release on the 0.9 branch. All users on PHP >= 5.3 are encouraged to use version 1.0 instead, which is mostly compatible.

• Add NodeTraverser::removeVisitor() method, which removes a visitor from the node traverser. The method was not added to the corresponding NodeTraverserInterface to avoid BC breaks with custom traversers (it is added in version 1.0).
• 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.
• Fix alias resolution in NameResolver: Class names are now correctly handled as case-insensitive.
• The undefined variable error, which is used in the lexer to reset the error state, will no longer interfere with custom error handlers.
• Make lexer compatible with xdebug.scream.

PHP-Parser 1.0.0 Beta 1

• [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-dev:

• [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.

PHP-Parser 0.9.4

• [PHP 5.5] Add support for ClassName::class. This is parsed as an Expr_ClassConstFetch with 'class' being the constant name.

• Syntax errors now include information on expected tokens and mimic the format of PHP's own (pre 5.4) error messages. Example:

  Old: Unexpected token T_STATIC on line 1
  New: Syntax error, unexpected T_STATIC, expecting T_STRING or T_NS_SEPARATOR or '{'
  

• PHPParser_PrettyPrinter_Zend was renamed to PHPParser_PrettyPrinter_Default as the default pretty printer only very loosely applies the Zend Coding Standard. The class PHPParser_PrettyPrinter_Zend extends PHPParser_PrettyPrinter_Default to maintain backwards compatibility.

• The pretty printer now prints namespaces in semicolon-style if possible (i.e. if the file does not contain a global namespace declaration).

• Added prettyPrintFile(array $stmts) method which will pretty print a file of statements including the opening <?php tag if it is required. Use of this method will also eliminate the unnecessary <?php ?> at the start and end of files using inline HTML.

• There now is a builder for interfaces (PHPParser_Builder_Interface).

• An interface for the node traversation has been added: PHPParser_NodeTraverserInterface

• Fix pretty printing of include expressions (precedence information was missing).

• Improve performance of PrettyPrinter construction by no longer using the uniqid() function.