PHP 8.2 Windows 下中文路径报错的根本原因是 UTF-8 路径与系统 ANSI（如 GBK）API 不匹配，需用 iconv("UTF-8", "GBK//IGNORE", $path) 转码；下载中文文件名须同时设置 filename 和 filename*=UTF-8''+rawurlencode() 响应头。
PHP 8.2 在 Windows 下下载服务器文件时遇到中文路径报错，根本原因不是 PHP 版本问题，而是 Windows 系统 API 调用路径时默认按 ANSI（如 GBK）解码，而你的 PHP 字符串是 UTF-8 编码——两者不匹配，fopen、file_get_contents、readfile 就会直接失败，报 failed to open stream: No such file or directory。
Windows 下必须手动转码路径字符串
PHP 8.2 不再自动兼容中文路径，尤其在 CLI 或 Apache 模块下行为更严格。不能依赖 mb_internal_encoding() 或 default_charset，它们对文件系统路径完全无效。
- 必须在调用
readfile()、fopen()前，把 UTF-8 路径转成当前系统代码页（通常是 GBK） - 推荐用
iconv("UTF-8", "GBK//IGNORE", $path)：//IGNORE 可跳过无法映射的字符，避免整条路径崩掉 - 别用
mb_convert_encoding($path, "GBK", "UTF-8")—— 它在某些 PHP 8.2 + VS17 构建版本中对路径处理不稳定 - 转换前建议加校验：
if (!mb_check_encoding($path, 'UTF-8')) { die('Invalid UTF-8 path'); }
下载响应头里中文文件名要分浏览器处理
即使路径读取成功，浏览器下载时中文文件名仍可能变 _.txt，这是 HTTP 头编码问题，和文件系统无关。
- 必须同时提供两种格式：
filename="log.txt"（兼容旧 IE） +filename*=UTF-8''%E6%97%A5%E5%BF%97.txt（RFC 5987 标准） - 不要只用
urlencode()：它会把空格转成+，部分浏览器解析异常；改用rawurlencode() - 完整写法示例：
header('Content-Type: application/octet-stream');<br>header('Content-Disposition: attachment; filename="log.txt"; filename*=UTF-8''' . rawurlencode('日志.txt'));<br>header('Content-Length: ' . filesize($safe_path));<br>readfile($safe_path);
路径拼接和根目录控制必须显式隔离
用户传来的路径参数（比如 $_GET['file']）绝不能直接拼进 __DIR__ 或 $_SERVER['DOCUMENT_ROOT']。
立即学习“PHP免费学习笔记（深入）”；
- 先用
basename()截断，再白名单校验：preg_match('/^[\x{4e00}-\x{9fa5}a-zA-Z0-9._-]{1,255}$/u', $name) - 定义绝对安全根目录：
define('DOWNLOAD_ROOT', 'C:/www/uploads/');（末尾带/） - 拼接后必须用
realpath()校验是否仍在该根目录内：if (str_starts_with(realpath(DOWNLOAD_ROOT . $name), realpath(DOWNLOAD_ROOT))) { ... } - 若
realpath()返回false，说明路径非法或含符号链接绕过，直接拒绝
最容易被忽略的是：路径转码和响应头编码是两件事，缺一不可。前者让 PHP 找得到文件，后者让浏览器正确显示文件名——中间任何一环没做，都会表现为“下载失败”或“乱码”，但错误位置完全不同。
