PHP rename() 处理含 emoji 文件名失败，因底层系统调用需完整 UTF-8 路径；须先检测并标准化编码、用 /u 修饰符正则替换、验证 mb_check_encoding()，并确保文件系统及协议层（如 Samba）支持 UTF-8。
PHP rename() 处理含 emoji 的文件名会失败
直接用 rename() 替换含 emoji 的文件名，大概率返回 false，且不报错——因为 PHP 默认以字节流处理路径，而 emoji 是 UTF-8 多字节字符（如 ? 占 4 字节），底层系统调用（如 Linux renameat()）若接收了被截断或编码不一致的字符串，就会静默失败。
必须确保整个路径是合法 UTF-8 字符串
关键不是“怎么替换”，而是“怎么让路径在 PHP 和 OS 层都保持一致的 UTF-8 解释”。常见错误包括：
• 从浏览器 URL 或表单提交拿到的文件名未用 urldecode() + mb_convert_encoding() 标准化
• 使用 iconv() 强转时忽略 //IGNORE 导致截断
• 没检查当前 locale 是否支持 UTF-8（setlocale(LC_CTYPE, 'en_US.UTF-8') 可能无效，依赖系统配置）
- 先用
mb_detect_encoding($filename, ['UTF-8', 'GB2312', 'BIG5'], true)确认原始编码，再转成 UTF-8 - 强制标准化：用
mb_convert_encoding($filename, 'UTF-8', 'UTF-8')清洗掉 BOM 或混合编码残留 - 验证：用
mb_check_encoding($filename, 'UTF-8')返回true才继续
实际替换操作要用 mb_ereg_replace() 或 preg_replace() 配合 u 修饰符
普通 str_replace() 对 emoji 无效，因为它按字节匹配；必须用支持 Unicode 的正则。例如把文件名中的 ? 替换为 ?：
$new_name = preg_replace('/?/u', '?', $old_name);
注意：
• /u 修饰符不可省略，否则 ? 被当 4 个乱码字节处理
• 若需替换多个 emoji 或动态 pattern，建议预编译正则（用 mb_ereg_replace() 已废弃，只推荐 preg_replace()）
• 文件扩展名部分（如 .png）要单独保留，避免误替换
立即学习“PHP免费学习笔记（深入）”；
Linux 下还需确认文件系统和挂载选项支持 UTF-8
即使 PHP 层全 UTF-8，如果 ext4 分区挂载时用了 iocharset=iso8859-1，或使用了旧版 NFS，emoji 名仍无法写入。检查方式：
mount | grep " /path/to/dir "
理想输出应含 utf8 或无显式 iocharset；若看到 iocharset=cp1251 或缺失 utf8 相关字样，就得重新挂载或改用 zfs/btrfs 等原生支持 Unicode 的文件系统。
最隐蔽的坑：MacOS HFS+ 和 Windows NTFS 默认支持 emoji 文件名，但通过 Samba 共享到 Linux 时，Samba 配置里没加 unix charset = UTF-8 和 dos charset = CP936，也会导致 rename 失败——这时问题不在 PHP，而在中间协议层。
