PHP readfile读取带重音文件名图片加载异常解决方案

一、无需PHP转发、直接访问公共目录文件的方案 #

直接访问失败的核心原因是Unicode标准化形式不匹配，不是Web服务器不支持非ASCII文件名：你调用encodeURI生成的地址里Nestle%CC%81属于NFD编码格式，把é拆成了普通字母e+组合尖重音符号两个Unicode字符，但绝大多数服务器文件系统（Windows的NTFS、Linux的ext4/XFS等）默认存储的文件名都是NFC格式——é作为单个Unicode字符（U+00E9）存储，对应百分号编码是%C3%A9。两边字节序列对不上，自然找不到文件。

直接访问的配置步骤：

• 统一服务器存储的文件名编码：所有上传到服务器的带重音文件名，统一转为NFC格式的UTF-8编码。注意macOS的APFS文件系统会强制把文件名存为NFD格式，如果是在mac设备上整理、上传文件，先批量把文件名转成NFC再上传，避免编码不匹配。
• 前端路径编码正确：写img的src属性时，不要直接裸写未编码的非ASCII字符，也不要直接调用默认的encodeURI（会输出NFD格式编码），可以手动对文件名部分做NFC标准化后再编码，最终URL里的é对应编码为%C3%A9而非e%CC%81。示例正确路径格式：

  <img src="[sitename]/images/products/Nestl%C3%A9-Coffee-Mate-Original-Lite-311g.jpg"/>
  

• 补全Web服务器配置：Nginx站点配置中加charset utf-8;，避免路径解析时的编码错误；Apache确保开启mod_encoding模块，设置文件名默认编码为UTF-8即可。配置完成后就可以直接访问公共目录的重音文件名图片，不需要经过PHP转发。

二、必须走PHP转发时的正确实现 #

你之前用rawurldecode、urldecode、utf8_decode都失败，核心原因是没有解决NFD/NFC编码不匹配的问题——你传过去的参数解出来是NFD格式的字符串，和磁盘上存的NFC文件名字节不一致，readfile自然找不到文件。其中utf8_decode的作用是把UTF-8转ISO-8859-1编码，用在这个场景只会把文件名转成乱码，完全不适用。

正确实现步骤：

1. 统一文件名编码：PHP端收到$folder、$name参数后，先做Unicode标准化，统一转为NFC格式，需要PHP安装intl扩展：

   // 开启intl扩展后调用
   $folder = Normalizer::normalize($folder, Normalizer::NFC);
   $name = Normalizer::normalize($name, Normalizer::NFC);
   

2. 做路径安全校验，避免路径遍历漏洞：

   // 拦截跨目录跳转字符
   if (str_contains($folder, '..') || str_contains($name, '..')) {
       http_response_code(403);
       exit;
   }
   $basePath = realpath(FCPATH . 'images/');
   $filePath = realpath($basePath . '/' . $folder . '/' . $name);
   // 校验文件存在，且路径没有跳出指定的图片目录，防止越权读取其他文件
   if (!$filePath || !str_starts_with($filePath, $basePath) || !is_file($filePath)) {
       http_response_code(404);
       exit;
   }
   

3. 输出图片时补全响应头，开启缓存减少性能损耗：

   $mimeType = mime_content_type($filePath);
   header("Content-Type: {$mimeType}");
   // 设置7天浏览器缓存，避免重复请求走PHP
   $cacheTime = 7 * 24 * 60 * 60;
   header("Cache-Control: public, max-age={$cacheTime}");
   header("Expires: " . gmdate("D, d M Y H:i:s", time() + $cacheTime) . " GMT");
   header("Content-Length: " . filesize($filePath));
   readfile($filePath);
   exit;
   

内容的提问来源于stack exchange，提问作者Jolan