AST解析是Laravel代码生成器的底层引擎，不是可选插件；所有真正落地的Laravel代码生成器（如ai:make-controller、Pint、IDE Helper）均依赖nikic/php-parser构建AST，通过Visitor模式安全遍历与修改节点，精准区分属性访问与方法调用，规避字符串替换风险，并保障PHP版本兼容性与上下文完整性。
AST解析是Laravel代码生成器的底层引擎，不是可选插件
所有真正落地的Laravel代码生成器（比如ai:make-controller、pint、IDE Helper）都依赖nikic/php-parser构建AST，而不是靠字符串替换或正则匹配。原因很简单：只有AST能准确区分$user->name是属性访问还是方法调用，才能安全插入验证逻辑、注入类型声明、或校验->validate()是否被遗漏。
常见错误现象：str_replace('class ', 'class MyPrefix', $code)会误改namespace App\Classes;里的class，而AST遍历只作用于Node\Stmt\Class节点，天然规避这类问题。
- PHP版本兼容性必须在解析阶段指定：
ParserFactory::ONLY_PHP82，否则PHP 8.2新增的readonly class节点会被忽略或报错 - AST节点不可直接修改，必须用
NodeTraverser配合Visitor实现——这是Laravel Pint和AI校验工具共用的模式 - 生成代码前务必调用
PrettyPrinter\Standard::prettyPrintFile($ast)，而非var_export或print_r，后者输出的是调试结构，不是合法PHP代码
Laravel控制器生成时，AST如何处理验证规则注入
AI生成的store()方法常漏掉$request->validated()或写成$request->all()，静态扫描无法识别语义风险，但AST可以。
关键判断点在Expr_MethodCall节点的$node->name->toString()是否为validated，且其父节点是否为Expr_Assign或参数传递目标。若缺失，校验工具会在对应行号标记CRITICAL: missing validation guard。
立即学习“PHP免费学习笔记（深入）”；
- 不要在
enter()里直接修改节点——这会破坏遍历顺序；应在leave()中返回替换后的节点 -
FormRequest类的规则定义（如['email' => 'required|email']）需先解析为AST，再映射到控制器方法体，不能仅靠注释或字符串匹配 - 动态拼接的字段名（如
$request->{$field}）属于高危模式，AST能捕获Expr_PropertyFetch中的变量属性访问，触发安全规则
为什么Laravel Pint和AI校验工具都用Visitor模式
因为Laravel代码结构稳定（Stmt_Class、Stmt_Function等节点类型极少变更），但规则需求高频迭代——今天要删未使用use，明天要加ReturnTypeWillChange注解，后天要检测eval()调用。Visitor模式让每条规则封装为独立类，不碰AST节点定义。
典型陷阱：有人试图在Visitor里用get_class($node)硬编码判断，但PhpParser\Node\Stmt\Class_和PhpParser\Node\Stmt\Interface_是不同类，应统一用$node instanceof Node\Stmt\ClassLike。
- Visitor必须实现
enter()和leave()两个方法，只实现一个会导致节点丢失或重复处理 - 多个Visitor需按顺序注册：
$traverser->addVisitor(new NoUnusedImports())，顺序影响最终输出（比如先删use再加use会白忙） - Laravel生态中
PhpParser\Node\Expr\MethodCall是高频操作目标，检查$node->name->toString() === 'validate'比正则/->validate\(\)/更可靠，不受换行/空格干扰
AST生成代码时最容易被忽略的上下文污染
用prettyPrintFile()输出代码后，如果直接file_put_contents()写入app/Http/Controllers/UserController.php，旧文件头部的<?php 和尾部?>可能被覆盖或重复，导致解析失败。这不是AST问题，而是上下文管理疏忽。
真实场景中，Laravel AI生成器会保留原文件的PHP标签位置、Shebang行、以及顶部注释块（如/** @apiResource ... */），这些信息不在AST里，必须从原始源码提取并拼接。
- 不要假设
$parser->parse($code)返回的AST包含全部源码信息——注释、空白、Shebang都不在节点中 - 生成新文件前，先用
token_get_all(file_get_contents($oldPath))提取头部PHP标签和注释，再与AST生成内容合并 - Swoole协程环境下，
NodeTraverser实例不能复用，每次生成必须新建，否则残留状态会影响后续遍历
