str_replace、preg_replace 不赋值则无效，rename在Windows下需UTF-16LE编码；所有替换操作必须接收返回值、验证前置条件、检查系统编码与权限。

str_replace 替换失败：最常被忽略的赋值问题

PHP 的 str_replace() 不会修改原字符串，而是返回新字符串。不接收返回值，就等于什么都没做。

• $text = "file.txt"; str_replace(".txt", ".php", $text); → $text 仍是 "file.txt"
• 正确写法必须重新赋值：$text = str_replace(".txt", ".php", $text);
• 对数组批量操作时同理：$files = str_replace([".jpg", ".png"], [".webp", ".avif"], $files);

preg_replace 匹配到了却不替换？检查分隔符和返回值

正则替换失败往往不是匹配逻辑错，而是语法或赋值疏漏。比如用竖线 | 作分隔符却忘了转义特殊字符，或压根没接返回值。

• 错误示例：$pattern = "|[a-z]+\.[a-z]+|"; preg_replace($pattern, "$0", $str); → $str 没变
• 正确写法：$str = preg_replace($pattern, "$0", $str);
• 若模式含点号、括号等，需转义：$pattern = '/\.(txt|log)$/i';（推荐用斜杠，更直观）

rename() 重命名文件失败：UTF-8 文件名是 Windows 上的隐形杀手

在 Windows 系统中，rename() 对 UTF-8 编码的文件名（如含土耳其语、阿拉伯语、中文）大概率失败，报错 The system cannot find the path specified。

• 根本原因：Windows API 默认期待 UTF-16LE，而 PHP 字符串是 UTF-8
• 解决方案：用 iconv("UTF-8", "UTF-16LE", $filename) 转换路径后再调用 rename()
• 更稳妥做法（尤其跨文件系统）：copy($old, $new) && unlink($old)，并检查每步返回值
• 别依赖 urlencode() —— 它编码的是 URL 路径，不是文件系统路径

文件名替换类操作失败的底层共性原因

无论用 str_replace 改字符串，还是 rename 改磁盘文件，失败常源于同一类低级但致命的假设。

• 路径拼接出错：用相对路径 "data/file.txt" 却没确认当前工作目录（getcwd() 查看），建议统一用 __DIR__ . '/data/file.txt'
• 文件不存在就操作：rename("old.txt", "new.txt") 前不检查 file_exists("old.txt")，直接静默失败
• 权限或占用：Linux 下目标目录无写权限，Windows 下文件被记事本/IDE 锁定，rename() 都会返回 false，但很多人不检查返回值
• 空字符串陷阱：str_replace("", "x", $s) 永远无效 —— PHP 不允许用空字符串做搜索项