PHP 解析器 PHP-Parser 5.0.0 发布

2024-02-0809:27:03后端程序开发Comments414 views字数 3349阅读模式

PHP-Parser是nikic用PHP编写的PHP5.2PHP8.3解析器,其目的是简化静态代码分析和操作。PHP Parser 是一个用于源代码解析的项目,值得一提的是它使用纯 PHP 编写,对于 PHP 程序员来说,能使用自己熟悉的语言来做静态分析等源码处理,无疑是一大便利。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/59365.html

5.0.0 发布列表

新增

  • 添加了PhpVersion 类,它在许多地方都被接受(例如ParserFactory,Parser,Lexer,PrettyPrinter),并对目标PHP版本进行更精确的控制。
  • 添加了PHP8解析器,尽管它与PHP 7解析器的区别仅在于连接优先级。
  • 添加了 Parser::getTokens() 方法。
  • 添加了一个 Modifiers 类,作为 Stmt\Class_::MODIFIER_* 的替代。
  • 添加了从 NodeVisitor::enterNode() 返回数组或 REMOVE_NODE 的支持。
  • 添加了许多额外的类型注释。PhpStan现在使用。
  • PHP-Fuzzer添加了一个模糊目标,这就是发现很多漂亮的打印机错误的原因。
  • Param上添加了isPromoted()isPublic()isProtected()isPrivate()isReadonly()方法。
  • 在trait builder中增加了对类常量的支持。
  • 添加了 PrettyPrinter 接口。
  • 添加了在切换静态修改器时对格式保留的支持。
  • php-parse二进制文件现在接受-作为文件名,在这种情况下,它将从stdin读取。
  • 支持NodeVisitor::REPLACE_WITH_NULL
  • 在漂亮的打印机中增加了对CRLF换行符的支持,使用新的newline选项。
  • 访问者现在可以直接传递给NodeTraverser构造函数。不再需要单独调用addVisitor()
  • NodeDumper中添加了对打印附加属性(如kind)的支持。
  • InterpolatedStringPart和heredoc/nowdocString_s添加了rawValue属性,该属性提供原始的未解析值。它以前只适用于非插值的单引号/双引号字符串。
  • 添加了Stmt\Block以表示{}代码块。以前,这样的代码块被展平到父语句数组中。Stmt\Block不会为通常与代码块一起使用的结构创建,例如if ($x) { $y; }将如前所述表示,而if ($x) { { $x; } }将具有额外的Stmt\Block包装器。

修改

  • 现在需要PHP 7.4来运行PHP-Parser。
  • 在可能的情况下添加了属性类型。
  • 标准漂亮打印机的屏幕已调整,以更紧密地匹配PSR-12。
  • 内部token表示现在使用PhpParser\Token类,它与PHP 8 token表示(PhpToken)兼容。
  • 数组解构现在总是使用Expr\List_节点表示,即使它使用[]语法。
  • 重命名了许多节点类,并将不是真实的表达式/语句的内容移到了Expr/Stmt层次结构之外。保留了旧名称的兼容性。
  • Pretty打印机不再无条件地将yield括在括号中,除非目标版本设置为早于PHP 7.0。
  • Pretty打印机现在默认为PHP 7.4作为目标版本。
  • 打印else if { }而不是else { if { } }
  • 访问者的leaveNode()方法现在以与enterNode()相反的顺序调用。
  • NodeTraverser::REMOVE_NODE等移至NodeVisitor::REMOVE_NODE。旧的常量仍然可用,以便兼容。
  • Name子节点parts已被name替换,它将名称存储为字符串,而不是由名称空间分隔符分隔的部分数组。getParts()方法返回旧的表示。
  • 不再接受Node构造函数中类型的字符串。相反,必须传递IdentifierNameComplexType
  • Comment::getReformattedText()现在将CRLF换行符规范化为LF换行符。
  • Lexer不再接受选项。Lexer\Emulative只接受PhpVersionstartLexing()getTokens()handleHaltCompiler()方法已被删除。相反,只有一个方法tokenize()返回令牌。
  • 属性处理已从词法分析器移到解析器,不再可配置。将始终添加comments、startLine、endLine、startTokenPos、endTokenPos、startFilePos和endFilePos属性。
  • 如果目标版本是>= 7.3(灵活的heredoc/nowdoc),pretty打印机现在缩进heredoc/nowdoc字符串。
  • 使用访问者分配评论。这解决了将注释分配给共享起始位置的所有节点的长期问题。现在只有最外层的节点将保存注释。
  • 提高NodeDumper在大型转储中的性能。

移除

  • PHP 5解析器已被删除。PHP 7解析器已经过调整,可以更优雅地处理PHP 5代码。
  • 删除了不推荐使用的Error构造函数,该构造函数采用行号而不是属性数组。
  • Comment::getLine()Comment::getTokenPos()Comment::getFilePos()方法已被删除。使用Comment::getStartLine()Comment::getStartTokenPos()Comment::getStartFilePos()代替。
  • 删除Stmt\Throw_节点,使用Stmt\Expression内的Expr\Throw_代替。
  • 删除ParserFactory::create()

固定

  • 漂亮的打印机现在使用一个更准确的处理一元运算符优先级,如果需要,只会把它们括在括号里。这允许修复许多其他与优先级相关的bug。
  • 漂亮的打印机现在尊重clonethrow和箭头函数的优先级。
  • 修复了替代elseif/else语法的格式保留。
  • 修复了将字符串打印为heredoc/nowdoc以适应灵活的文档字符串语义的安全性检查。
  • 修复了文档字符串末尾的\r可能被错误地合并到CRLF序列中,后面是\n的各种情况。
  • __halt_compiler不再被识别为半保留关键字,符合PHP行为。
  • <?=不再被识别为半保留关键字。
  • 修复了对非常大的溢出\u转义序列的处理。
  • 在格式保留打印机中不修剪前导空格。
  • 根据目标PHP版本,在格式保留打印机中将DEL视为标签字符。
  • 修正了在没有明确指定错误处理程序的情况下,在模拟lexer中报告错误的问题。
  • 优雅地处理Differ中的非连续数组索引。

弃用

  • Node::getLine()方法已被弃用。使用Node::getStartLine()代替。

简单使用

对于以下一段 PHP 代码文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/59365.html

<?php
echo 'Hi', '开源技术小栈';

编写解析文件

<?php
require __DIR__ . '/../vendor/autoload.php';

$code = <<<'CODE'
<?php

echo 'Hi', '开源技术小栈';

CODE;

$parser = (new \PhpParser\ParserFactory())->createForNewestSupportedVersion();
try {
    $ast = $parser->parse($code);
} catch (\PhpParser\Error $error) {
    echo "Parse error: {$error->getMessage()}\n";
    return;
}

$dumper = new \PhpParser\NodeDumper;
echo $dumper->dump($ast) . "\n";

解析后生成的树结构如下

array(
    0: Stmt_Echo(
        exprs: array(
            0: Scalar_String(
                value: Hi
            )
            1: Scalar_String(
                value: 开源技术小栈
            )
        )
    )
)
文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/59365.html
  • 本站内容整理自互联网,仅提供信息存储空间服务,以方便学习之用。如对文章、图片、字体等版权有疑问,请在下方留言,管理员看到后,将第一时间进行处理。
  • 转载请务必保留本文链接:https://www.cainiaoxueyuan.com/bc/59365.html

Comment

匿名网友 填写信息

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen:

确定