php 8.4 中文文件名乱码源于客户端与服务端编码不一致，需统一编码链路：html 声明 utf-8、表单加 accept-charset、php 手动检测转换编码、保存用安全英文名、下载时用双 header 设置中文名。
PHP 8.4 上传文件时中文名变成问号、方块或乱码，核心原因是客户端（浏览器）发送的文件名编码与服务端 PHP 解析方式不一致。PHP 8.4 对多字节字符更严格，旧方法容易失效。解决关键在于**统一编码链路：前端传、服务端收、后端存、浏览器识**。
确保 HTML 表单正确声明编码
表单本身必须明确告知浏览器用 UTF-8 编码提交文件名：
- HTML 页面 `` 中必须有：
- 表单标签添加 accept-charset="UTF-8" 属性：
<form action="upload.php" method="post" enctype="multipart/form-data" accept-charset="UTF-8"></form> - 避免使用 GBK/GB2312 等老旧编码，即使页面能显示也不代表文件名被正确传输
PHP 端正确获取并转义原始文件名
PHP 8.4 不再自动解码 `$_FILES['file']['name']` 中的 UTF-8 字节流，需手动处理：
- 先检测原始文件名是否为 UTF-8：
$rawName = $_FILES['file']['name'];<br>if (!mb_detect_encoding($rawName, 'UTF-8', true)) {<br> $rawName = mb_convert_encoding($rawName, 'UTF-8', 'auto');<br>} - 若确定来源是 Windows 客户端（常见 GBK），可强制转换：
$fileName = iconv('GBK', 'UTF-8//IGNORE', $rawName); - 更稳妥做法：用 mb_convert_encoding 多编码尝试识别：
$fileName = mb_convert_encoding($rawName, 'UTF-8', 'UTF-8, GBK, GB2312, BIG5');
保存文件时使用安全的英文/时间戳名，保留原始中文名作记录
直接用中文名创建文件在 Linux 或部分 Windows 环境下仍可能失败。推荐分离策略：
- 生成唯一安全文件名（如时间戳+随机字符串）用于存储：
$safeName = date('YmdHis') . '_' . uniqid() . '.' . pathinfo($rawName, PATHINFO_EXTENSION);<br>move_uploaded_file($_FILES['file']['tmp_name'], 'upload/' . $safeName); - 将原始中文名存入数据库或 JSON 日志，供后续展示或下载时还原：
file_put_contents('upload/log.json', json_encode(['original' => $rawName, 'saved_as' => $safeName], JSON_UNESCAPED_UNICODE) . "\n", FILE_APPEND);
下载时正确输出中文文件名（延伸场景）
如果上传后要提供下载，且希望下载框显示中文名，需在响应头中规范设置：
- 使用双 header 兼容主流浏览器：
$filename = '订单报表_202609.xlsx';<br>$encoded = rawurlencode($filename);<br>header('Content-Type: application/octet-stream');<br>header("Content-Disposition: attachment; filename=\"$encoded\"; filename*=UTF-8''$encoded"); - 务必在任何输出前调用，且确认无空格、BOM 或 warning 干扰 header 发送
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
