phpast扩展不支持PHP 8.0+，仅兼容至PHP 7.2；推荐改用nikic/php-parser库，它纯PHP实现、支持PHP 5.6–8.3全版本，提供AST遍历、修改与代码生成功能。
phpast 扩展不支持 PHP 8.0+，别白费时间编译
phpast 是一个已停止维护的 PHP 扩展，最后更新停留在 PHP 7.2，它无法在 PHP 8.0 及更高版本中编译通过。你执行 ./configure 或 make 时大概率会遇到类似 error: ‘zend_ast’ has no member named ‘attr’ 的报错——这是因为 PHP 8.0 彻底重构了 AST 内部结构，zend_ast 成员和内存布局全变了。
如果你正在用 PHP 8.1/8.2/8.3，直接放弃 phpast；它不是“配置不对”，而是根本性不兼容。
- PHP 7.2 是它唯一能稳定运行的最高版本
- 即使降级到 PHP 7.2，也需手动打补丁才能适配某些发行版的构建环境
- 没有 Windows 官方二进制包，Windows 用户基本不可用
替代方案：用 php-parser 库解析 AST（推荐）
现在主流且活跃的 PHP AST 操作方式是 nikic/php-parser，纯 PHP 实现，支持 PHP 5.6 到 PHP 8.3 的全部语法，且提供清晰的遍历、修改、生成接口。
安装很简单：
立即学习“PHP免费学习笔记（深入）”；
composer require nikic/php-parser
基础用法示例：读取文件并打印函数名列表
$parser = (new PhpParser\ParserFactory)->create(PhpParser\ParserFactory::PREFER_PHP7);
$ast = $parser->parse(file_get_contents('example.php'));
$traverser = new PhpParser\NodeTraverser();
$traverser->addVisitor(new class extends PhpParser\NodeVisitorAbstract {
public function enterNode(PhpParser\Node $node) {
if ($node instanceof PhpParser\Node\Stmt\Function_) {
echo "Found function: {$node->name->name}\n";
}
}
});
$traverser->traverse($ast);
- 所有节点类型都定义在
PhpParser\Node\*命名空间下，比如PhpParser\Node\Expr\BinaryOp\Plus - 修改 AST 要返回替换节点（或
null删除），不能直接改属性 - 生成 PHP 代码用
PhpParser\PrettyPrinter\Standard，不是原生字符串拼接
为什么不用 ext/ast（PHP 7.0+ 自带扩展）？
PHP 7.0 引入了内置的 ast 扩展（需编译开启 --enable-opcache 并加载 extension=ast），但它只提供只读 AST 数组，不支持节点修改或代码生成。
典型用法：
$ast = ast\parse_file('test.php', 70); // 第二个参数是版本号，70 表示 PHP 7.0 格式
var_dump(ast\get_kind_name($ast->kind)); // 输出 "AST_STMT_LIST"
- 返回的是嵌套数组 + 对象混合结构，没有类型提示，IDE 不友好
- 节点无方法，无法链式调用或安全判断类型，得靠
instanceof或ast\get_kind_name() - 不能用于代码重写场景（如自动加日志、AOP 注入），只能做静态分析
- PHP 8.0+ 中该扩展未同步更新语法支持，部分新特性（如 match 表达式）会解析失败或降级为
AST_INVALID
真实项目中 AST 操作最容易卡住的点
不是不会写 Visitor，而是忽略上下文和副作用。比如你想给每个 echo 前加一行调试输出：
- 不能只匹配
PhpParser\Node\Stmt\Echo_，还要考虑它是否在函数内、是否被条件包裹，否则可能污染全局作用域 - 修改节点后必须用
PrettyPrinter重新生成代码，但默认格式会丢失原始空行和注释——要用PhpParser\PrettyPrinter\Standard的printFormat配置项微调 - 如果源码含 heredoc / nowdoc，php-parser 默认不保留原始缩进，需启用
PhpParser\Lexer\Emulative并传入['usedAttributes' => ['comments', 'startLine', 'endLine']] - 批量处理多个文件时，
Parser实例可复用，但NodeTraverser每次都要新建，否则上次注册的 Visitor 会残留
AST 操作真正难的从来不是“怎么拿到节点”，而是“改完之后还能不能跑、会不会悄悄破坏语义”。动手前先用 var_dump 看三遍原始 AST 结构，比查文档快得多。
