basename()第二个参数可直接剥离指定扩展名，但仅精确匹配末尾字符串，不支持通配或多扩展名；安全去扩展名应使用pathinfo($path, PATHINFO_FILENAME)。
basename() 提取文件名时容易忽略的第二个参数
basename() 不只是取文件名，它能直接剥离扩展名——但很多人写成 basename($path) 后再用 str_replace() 或 pathinfo() 二次处理，其实多余。
第二个参数是扩展名（字符串，非正则），传入后会从结果里直接去掉：
$path = '/var/www/uploads/photo.jpg'; echo basename($path, '.jpg'); // 输出：photo echo basename($path, '.png'); // 输出：photo.jpg（没匹配上，原样返回）注意：basename($path, '.jpg') 只匹配末尾**恰好等于**该字符串的部分，不支持通配或多个扩展名同时剥离。想安全去扩展名，还是得用 pathinfo($path, PATHINFO_FILENAME)。
替换文件名时别直接拼字符串，用 dirname() + basename() 组合
要改名并保持原路径结构（比如把 old.pdf 改成 new_v2.pdf），硬连 dirname($path) . '/new_v2.pdf' 看似简单，但 windows 路径分隔符、末尾斜杠缺失、符号链接路径等场景下容易出错。
立即学习“PHP免费学习笔记（深入）”；
更稳妥的做法是拆解再组装：
- 用
dirname($path)拿目录部分（自动适配系统分隔符） - 用
basename($path, '.' . pathinfo($path, PATHINFO_EXTENSION))或pathinfo($path, PATHINFO_FILENAME)拿纯文件名 - 拼接新名字时，显式加
/并用realpath()或str_replace('\', '/', ...)统一路径格式（如需兼容）
$path = 'C:\Users\test\report.docx'; $dir = dirname($path); // C:Userstest $name = pathinfo($path, PATHINFO_FILENAME); // report $newPath = $dir . '/' . $name . '_final.docx'; // 注意：windows 下 dirname 返回 ，这里混用 / 也OK（php 内部可识别）rename() 前必须确保目标目录可写，且不能跨文件系统
用 rename() 改名失败常见报错：Warning: rename(): No such file or Directory 或 Invalid cross-device link。前者常因目标父目录不存在或权限不足；后者说明源和目标在不同挂载点（比如 /tmp 和 /home 分属不同磁盘分区）。
处理建议：
- 用
is_writable(dirname($target))提前检查写权限 - 用
realpath(dirname($source)) === realpath(dirname($target))判断是否同设备（不绝对可靠，但可筛掉大部分跨分区情况） - 跨设备必须用
copy()+unlink()替代rename()
批量替换文件名里的特定字符串，用 str_replace() 要小心扩展名误伤
比如要把所有 draft_ 前缀删掉：draft_report_v1.pdf → report_v1.pdf。若直接对完整路径 str_replace('draft_', '', $path)，可能把 /home/drafts/ 目录名也干掉了。
正确做法是只操作文件名部分：
$path = '/home/drafts/draft_note.txt'; $info = pathinfo($path); $newName = str_replace('draft_', '', $info['filename']); $newPath = $info['dirname'] . '/' . $newName . '.' . $info['extension'];如果要支持多种前缀或正则逻辑，改用 preg_replace() 作用于 $info['filename']，避免污染路径结构。
文件名替换真正的复杂点不在函数调用，而在于路径解析的边界情况——basename() 的第二个参数只做后缀精确匹配，rename() 跨设备静默失败，还有 Windows 路径大小写与 php 函数行为差异。这些地方不测真实环境，光看文档很容易漏。