PHP替换文件内容本身不会死循环，死循环只发生在递归遍历目录时未防护符号链接或./..，或边读边写同一文件触发监听；需过滤.和..、用lstat检测symlink、优先使用RecursiveDirectoryIterator并设SKIP_DOTS标志。
PHP替换文件内容本身不会死循环——死循环只发生在你用递归遍历目录时没防住符号链接或./..，或者在替换逻辑里误写成“边读边写同一文件”导致反复触发监听/钩子。真正要防的是**遍历环节的无限递归**，不是str_replace本身。
scandir()递归遍历时跳过.和..只是基础，不够
漏掉这两项确实会立刻引发递归爆炸：比如scanDirectory($path . '/.')等于原地调用自己，scanDirectory($path . '/..')则往上跳一级再往下钻，来回打转。
- 必须显式过滤：
if ($item === '.' || $item === '..') continue; - 但光这样不行——符号链接（symlink）仍能绕过，比如
/var/www/html→/var/www，is_dir()返回true，scandir()照常读，递归就进环了 - 更隐蔽的是挂载点跨文件系统时
realpath()可能失效，此时得改用lstat($fullPath)查FILEINFO_SYMLINK位来主动识别并跳过
用RecursiveDirectoryIterator代替手写递归更稳
原生迭代器自带防护，不用操心路径去重和深度控制，重点是别让它误入不该碰的目录。
- 构造时加标志：
new RecursiveDirectoryIterator($root, FilesystemIterator::SKIP_DOTS)，自动跳过./.. - 扩展名过滤用
pathinfo($file->getPathname(), PATHINFO_EXTENSION)，比substr()靠谱，避免.tar.gz被错判为gz - 每次处理前校验：
$file->isFile() && $file->isWritable()，跳过目录、只读文件、socket或设备节点 - 绝对不要在迭代过程中删/移/重命名当前遍历的目录——PHP迭代器底层缓存路径列表，结构变动会导致
UnexpectedValueException或跳过文件
替换单个文件时，file_get_contents + str_replace + file_put_contents必须原子化
这不是死循环问题，但错误写法会让脚本卡住或文件变空——比如file_put_contents失败后没检查返回值，后续逻辑还拿空字符串继续操作。
立即学习“PHP免费学习笔记（深入）”；
- 读取后先判
false：$content = file_get_contents($path); if ($content === false) { /* 记录错误并跳过 */ } - 写入加
LOCK_EX：file_put_contents($path, $newContent, LOCK_EX)，防止并发写覆盖 - 编码要对齐：用
mb_detect_encoding($content)探源编码，必要时mb_convert_encoding($content, 'UTF-8', $encoding)统一后再替换 - 操作前备份：
copy($path, $path . '.bak')，出错可回滚；注意.bak文件别被下一轮遍历又匹配上
批量替换大量文件时，别盲目扫全目录
真实项目里./底下有node_modules、vendor、storage/logs，硬扫轻则慢，重则内存爆掉或触发系统限制。
- 优先用
git grep -l "search_term" -- "*.php"定位目标文件，再针对性处理 - 框架项目（Laravel/Symfony）直接盯
config/、resources/views/、routes/这些明确位置 - 如果真要全盘扫，加深度限制：
$iterator = new RecursiveIteratorIterator($it, RecursiveIteratorIterator::LEAVES_ONLY); $iterator->setMaxDepth(4); -
preg_replace模式别在循环里拼接，提取为常量；用户输入的搜索词必须用preg_quote($userInput, '/')转义，否则正则注入会让整个替换逻辑失控
最易被忽略的点：符号链接可能指向外部挂载卷，realpath()返回false或不一致路径，此时in_array($realPath, $visited)失效——得靠lstat()+FILEINFO_SYMLINK双检，而不是依赖路径字符串相等。
