如何使用Composer引入 PHP-Parser 库实现对 PHP 源代码的深度分析与修改-composer-PHP中文网

需先确认php-parser版本兼容性：php 7.4–8.0用^4.15，8.1–8.2用^5.0（推荐^5.1）；解析时须显式指定php版本、开启注释保留；修改ast应使用leavenode安全替换，printer用standard避免格式破坏。

如何使用composer引入 php-parser 库实现对 php 源代码的深度分析与修改

直接用 `composer require` 装不上？先确认 PHP-Parser 版本兼容性

PHP-Parser 不是单一包，而是由 nikic/php-parser 提供的语法树解析器，不同主版本（v4/v5/v5.1）对 PHP 语言特性支持差异大。比如 v4 不支持 PHP 8.0 的联合类型、属性 Promotion；v5.1 才完整支持 PHP 8.2 的只读类和枚举成员初始化。装错版本会导致 PhpParser\Parser 解析失败或抛出 PhpParser\Error 异常，且错误信息常为“Unexpected token”，实际是语法不识别。

PHP 7.4–8.0 → 用 composer require nikic/php-parser:^4.15
PHP 8.1–8.2 → 用 composer require nikic/php-parser:^5.0（推荐 ^5.1）
若项目已含其他依赖间接引入旧版，执行 composer why nikic/php-parser 查冲突来源

解析失败时别急着改代码，先检查 `Parser` 的配置项

默认 Parser 只支持 PHP 7 语法，即使你用的是 PHP 8.2，也得显式指定语言版本，否则遇到 enum 或 readonly 就报错。另外，Parser 默认不保留注释和空白，但做代码修改时必须开启，否则 AST 里没有 Comment 节点，重写后注释全丢。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

正确初始化：

$parser = (new PhpParser\ParserFactory())->create(PhpParser\ParserFactory::ONLY_PHP82, [
    'throwOnError' => false,
    'skipComments' => false,
    'retainComments' => true,
]);

throwOnError 设为 false 后，parse() 返回 null 而非抛异常，需手动检查：if (!$stmts) { throw new RuntimeException($parser->getErrors()[0]->getMessage()); }
不要用 ParserFactory::PREFER_PHP7 —— 它会降级尝试，反而掩盖真实语法问题

修改 AST 后输出代码，`prettyPrint` 和 `print` 别混用

NodeDumper 是看结构用的，不是生成代码的工具；真正重写源码得靠 Printer。但 Printer\Standard 和 Printer\PrettyPrint 行为完全不同：前者按原始缩进/换行输出（适合保留风格），后者强制格式化（会删空行、统一缩进），导致 diff 巨大，不利于 Git 提交审查。

安全做法：用 new PhpParser\Printer\Standard()，它尊重原始节点的 getStartLine() 和 getEndLine()，并保留 Comment 节点位置
若需格式化，单独调用 php-cs-fixer 或 phpcbf，不要让 Printer 承担此职责
修改节点后务必调用 $node->setAttribute('parent', null) 清除父引用，否则 Printer 可能因循环引用崩溃

遍历和修改节点时，`NodeVisitor` 的 `enterNode` 和 `leaveNode` 用法有陷阱

很多用户以为只在 enterNode 里改节点就够了，结果发现 Class_ 里的 Method 没被处理到 —— 因为 enterNode 是深度优先进入，而子节点还没遍历完；真正安全的修改时机是 leaveNode，此时整个子树已处理完毕，返回值可替换整棵子树。

想给所有函数加日志？在 leaveNode 中判断 $node instanceof PhpParser\Node\Stmt\Function_，然后 return new PhpParser\Node\Stmt\Expression(...) 插入语句
想删掉某个 echo？在 enterNode 返回 NodeTraverser::DONT_TRAVERSE_CHILDREN 防止误删嵌套内容；但删除动作本身要在 leaveNode 返回 []（空数组）实现
别在 enterNode 直接 unset($node->stmts[0]) —— 这样破坏节点完整性，Printer 会跳过后续处理