PHP rename() 可直接处理含#文件名（Linux/macOS支持），无需特殊转义；关键在确保输入未被URL/shell截断或双重编码，如$_GET需urldecode()，$_FILES['name']则无需解码。
PHP rename() 替换文件名的基本写法
直接用 rename() 就行，但要注意路径必须完整、权限得够、目标目录得存在。它不自动创建父目录，也不能跨文件系统（比如从 /tmp 重命名到 /home 可能失败）。
常见写法：
rename('/path/old.txt', '/path/new.txt');返回 true 表示成功，false 失败 —— 但不会告诉你为什么失败，得靠 error_get_last() 或提前检查：
-
file_exists()确认源文件存在 -
is_writable()检查源目录和目标目录是否可写 -
dirname()的父目录是否存在，不存在得先mkdir(..., 0755, true)
含井号（#）的文件名在 PHP 中怎么安全处理
井号本身在 URL 和 shell 中是特殊字符，但在 PHP 文件系统函数里不是保留字，rename() 能直接操作含 # 的文件名 —— 前提是你的操作系统允许它作为文件名的一部分（Linux/macOS 允许，Windows 不允许）。
立即学习“PHP免费学习笔记（深入）”；
真正的问题出在：你从 URL、表单或命令行拿到带 # 的文件名时，它很可能已经被截断或编码过。比如：
-
浏览器地址栏里
file#1.txt会被当成锚点，$_GET拿不到#后内容 -
前端用
encodeURIComponent()编码后变成file%231.txt，PHP 接收后需urldecode() - shell 命令中未引号包裹的
mv file#1.txt new.txt会报错，因为#被当注释
所以重点不是 PHP 函数本身，而是「输入来源是否可信、是否被意外截断」。
rename() 处理含 # 文件名时的典型错误现象
最常遇到的不是 PHP 报错，而是「静默失败」或「找不到文件」：
-
Warning: rename(): No such file or directory→ 实际是源路径拼错了，比如漏了urldecode()，传进去的是file%231.txt而非file#1.txt -
Warning: rename(): Permission denied→ 目标路径父目录不可写，尤其当新文件名含#且你误以为要对#做额外转义时，反而拼出非法路径 - 脚本在 CLI 下正常，Web 下失败 → Web 服务器用户（如
www-data）没权限访问该文件，和#无关，但容易误判
验证方法：用 var_dump(realpath($source)); 看实际解析路径，再用 ls -la 手动确认文件是否存在。
PHP 里要不要对 # 做额外转义或过滤
不需要。PHP 的 rename()、file_exists()、fopen() 都原生支持含 # 的文件名（Linux/macOS 下）。强行用 str_replace('#', '\#', $name) 反而会生成真实文件名里带反斜杠的文件，造成混乱。
唯一要做的，是确保输入值未经意外截断或双重编码：
- 来自
$_POST或$_GET？先urldecode() - 来自
$_FILES['file']['name']？它已是原始文件名，不用解码，但需注意上传时浏览器是否已重命名（比如把#替换成_） - 用
escapeshellarg()包裹再丢给shell_exec()？那是 shell 场景，和rename()无关
真要过滤，也只应按业务规则来（比如禁止 #），而不是因为技术限制。
井号本身不危险，危险的是你以为它危险而乱加转义，或者没意识到 URL、shell、上传协议各自对它的处理逻辑完全不同。
