sed批量替换PHP函数名最快但需注意跨行和误匹配；preg_replace可加词边界提升精度但仍有限；PHP-Parser基于AST重构最精准可靠，能避免字符串/注释误改，但学习成本高。
用 sed 批量替换 PHP 文件中的函数名（Linux/macOS）
直接在终端里改一堆 .php 文件的函数名，sed 是最快落地的方式，但必须加 -i 参数才真正写入文件，且正则要转义括号和美元符。比如把 mysql_connect() 换成 mysqli_connect()：
sed -i 's/mysql_connect(/mysqli_connect(/g' *.php
注意点：
-
sed -i在 macOS 上需加空参数：sed -i '' 's/.../.../g' *.php - 如果函数带参数或换行，
sed无法跨行匹配，此时会漏掉多行调用 - 别忘了先
git status确认范围，或先用sed 's/.../.../g' file.php预览效果
用 preg_replace 在 PHP 脚本中安全替换（带上下文判断）
当需要识别「是函数调用而非字符串或注释里的同名文本」时，纯文本替换容易误伤。preg_replace 可配合词边界 \b 和前后空白/括号约束：
$content = file_get_contents('example.php');
$content = preg_replace('/\bmysql_connect\s*\(/', 'mysqli_connect(', $content);
file_put_contents('example.php', $content);
关键限制：
立即学习“PHP免费学习笔记（深入）”；
-
\b能防止匹配到my_mysql_connect这类子串，但对$mysql_connect无效（因为$不是单词字符） - 没处理命名空间、静态调用（如
DB::mysql_connect()）或闭包内引用，得加更复杂的正则或改用 AST - 一次只处理一个文件，批量操作需
glob()遍历，记得跳过vendor/和缓存目录
用 PHP-Parser 做 AST 级重构（精准、可扩展）
真正可靠的函数名替换，得解析成抽象语法树（AST），只改函数调用节点，不碰字符串、变量名或注释。PHP-Parser 是目前最稳的选择：
composer require nikic/php-parser
写一个 NodeVisitor 子类，重写 enterNode 方法：
if ($node instanceof \PhpParser\Node\Expr\FuncCall && $node->name instanceof \PhpParser\Node\Name) {
if ($node->name->toString() === 'mysql_connect') {
$node->name = new \PhpParser\Node\Name('mysqli_connect');
}
}
这样能避开所有文本陷阱，但代价是：
- 学习成本明显高于
sed，需理解 AST 节点类型（如FuncCall、MethodCall、StaticCall） - 第三方库函数（非内置）需额外判断命名空间，否则可能把
App\Helper\mysql_connect()也错了 - 修改后生成代码格式会重排，若项目有严格 PSR-12 格式要求，得配
php-cs-fixer二次处理
为什么不能只靠 IDE 的「全局重命名」？
PHPStorm 或 VS Code 的重命名功能在多数场景下够用，但它依赖索引和符号解析，遇到以下情况就失效：
- 函数定义在
eval()字符串里，或通过call_user_func('mysql_connect')动态调用 - 项目用了自定义 autoloader，没被 IDE 正确识别类/函数注册路径
- 函数名拼写不一致（如大小写混用），而 PHP 是大小写敏感的函数名但不敏感的类名，IDE 可能漏判
- 替换后没运行测试，比如
mysqli_connect()参数顺序和返回值跟旧版不同，光改名不改逻辑必报错
AST 方案能覆盖动态调用的识别（只要字符串可静态分析），但依然无法处理运行时拼接的函数名——那种就得人工 review。
