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 改磁盘文件，失败常源于同一类低级但致命的假设。
立即学习“PHP免费学习笔记（深入）”；
- 路径拼接出错：用相对路径
"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 不允许用空字符串做搜索项
实际项目里，90% 的“替换失败”不是函数不会用，而是忘了检查返回值、没验证前置条件、或在错误的编码层面上操作路径。尤其当文件名走出 ASCII 范围，问题就从逻辑层下沉到系统 API 层——这时候，var_dump(iconv("UTF-8", "UTF-16LE", $name)) 比任何文档都管用。