preg_replace() 仅处理文件名字符串，需先用 basename() 提取文件名再替换，配合 dirname() 拼回路径；扩展名点号须转义为 \.，捕获版本号应使用 preg_replace_callback() 动态自增；跨文件系统重命名需 copy()+unlink()，并校验权限与目标存在性；正则应加锚点、明确字符集、避免过度通配。
用 preg_replace() 处理文件名字符串
PHP 本身不直接操作文件系统重命名，所谓“文件名替换”本质是先对文件名字符串做正则处理，再调用 rename()。核心在字符串层面匹配与替换，不是改文件内容。
常见错误是把路径全传给 preg_replace()，结果连目录部分也被误替换。必须先用 basename() 提取纯文件名，再处理。
- 始终用
basename($filepath)分离文件名，避免路径干扰 - 替换后拼回原路径：
dirname($filepath) . '/' . $new_filename - 注意转义点号：
\.匹配真实扩展名分隔符，否则.会匹配任意字符 - 区分大小写：默认
preg_replace()区分，如需忽略加i修饰符（/pattern/i）
匹配并替换带编号的旧版文件名（如 report_v1.pdf → report_v2.pdf）
这种场景要捕获版本号并自增，不能硬编码替换。关键是用 $1、$2 引用捕获组，配合 preg_replace_callback() 动态计算新值。
function incrementVersion($matches) {
return $matches[1] . 'v' . ((int)$matches[2] + 1) . $matches[3];
}
$filename = 'report_v1.pdf';
$newname = preg_replace_callback('/^(report_)(v\d+)(\.pdf)$/', 'incrementVersion', $filename);
// 结果：report_v2.pdf注意：$matches[0] 是完整匹配，[1]、[2] 等才是括号内捕获的内容。数字编号若可能为多位（如 v12），仍可用 (v\d+) 安全捕获。
立即学习“PHP免费学习笔记（深入）”；
批量重命名时绕过 rename() 的权限和跨文件系统限制
rename() 在 Linux 下无法跨挂载点（比如从 /home 移到 /mnt/usb），Windows 对正在使用的文件也常失败。此时不能只靠正则+rename()。
- 跨分区必须用
copy()+unlink()组合 - 检查目标是否存在：
if (file_exists($target)) { /* 处理冲突 */ } - 用
is_writable(dirname($target))提前验证写权限，避免静默失败 - Windows 下建议加
@抑制警告，或用trigger_error()捕获rename()返回false的情况
正则里容易踩的坑：扩展名、空格、特殊字符
文件名含空格、括号、中文或方括号时，正则会意外截断或报错。根本原因是没正确转义或边界控制。
- 匹配整个文件名用锚点：
/^mydoc_\d{4}\.pdf$/，避免部分匹配 - 扩展名固定时，结尾必须写
\.pdf，不是.pdf - 含空格文件名：用
[\s\S]或.*?非贪婪匹配，但更稳妥是明确范围，如[a-zA-Z0-9_\-\s]+ - 中文文件名无需额外处理，UTF-8 下
mb_函数非必需；但若用u修饰符（/pattern/u），需确保 PCRE 支持 UTF-8
实际中，越具体的模式越可靠。与其写 /.*/，不如写 /^data_[a-z]+_\d{6}\.csv$/ —— 模糊匹配留下的余地，最后都变成 bug 的藏身之处。
