PHP在Windows下用file_put_contents写入中文路径失败，因UTF-8路径未转为GBK编码；应使用mb_convert_encoding($path, 'GBK', 'UTF-8')手动转码，Linux/macOS则无需处理。
PHP file_put_contents 写入中文路径失败报错
直接用 file_put_contents 写入含中文的路径（如 './数据/日志.txt'），在 Windows 下常报 failed to open stream: No such file or directory。这不是权限问题，而是 PHP 默认以系统本地编码（如 GBK）解析路径，而脚本文件和运行环境多为 UTF-8，导致路径字符串被错误解码。
- Windows 系统 API 路径调用依赖 ANSI 编码（
CP936），PHP 7.4+ 在 Windows 上对fopen/file_put_contents的路径参数做了 UTF-8 自动转码，但仅限于「当前活动代码页支持的字符」；超出范围（如某些生僻汉字、emoji）仍会失败 - Linux/macOS 不涉及此问题，因为其文件系统原生支持 UTF-8 路径，但需确保终端、locale 和 Web 服务器（如 Nginx/Apache）均配置为
UTF-8 - 最稳妥做法：不依赖自动转码，手动将路径转为系统可识别编码——Windows 下用
mb_convert_encoding($path, 'GBK', 'UTF-8')，再传入函数
mkdir 创建中文目录时提示 mkdir(): Invalid argument
mkdir 同样受路径编码影响，尤其在递归创建（mkdir($path, 0755, true)）时，中间某一级含中文就可能中断。关键不是权限或父目录缺失，而是路径字节流无法被 Windows CreateDirectoryA 接收。
- 不要对整个路径做
urlencode或 base64，那会生成非法文件名 - 避免用
iconv('UTF-8', 'GBK', $path)——它在转换失败时默认返回空字符串，静默出错；改用mb_convert_encoding并检查返回值是否与原字符串等长 - 推荐封装一个安全路径函数：
function safe_path($path) { return PHP_OS_FAMILY === 'Windows' ? mb_convert_encoding($path, 'GBK', 'UTF-8') : $path; }然后统一用mkdir(safe_path('./用户上传/张三'))
文件名含中文但浏览器下载时变成乱码或下划线
这属于 HTTP 响应头问题，和文件系统无关。即使路径写入成功，Content-Disposition 头中 filename= 后的中文未正确编码，Chrome/Firefox 会拒绝解析，降级为 filename=_.txt。
- 必须用
filename*=UTF-8''格式（RFC 5987），例如：Content-Disposition: attachment; filename="log.txt"; filename*=UTF-8''%E6%97%A5%E5%BF%97.txt - PHP 中用
rawurlencode编码文件名（不是urlencode），并注意保留原始扩展名：$filename = '访问记录.txt'; $header = 'Content-Disposition: attachment; filename="' . basename($filename) . '"; filename*=UTF-8\'\'' . rawurlencode($filename);
- IE 11 及更早版本只认
filename（无星号），可做兼容 fallback，但现代项目通常无需支持
为什么 scandir 读出的中文文件名是乱码
scandir 返回的数组元素是原始字节流，在 Windows 下就是 GBK 编码的字符串。若 PHP 脚本是 UTF-8，直接 echo 或 json_encode 就会显示为乱码（如 ä¸）。
立即学习“PHP免费学习笔记（深入）”；
- 不能对结果整体
utf8_encode——该函数只适用于 ISO-8859-1 → UTF-8，对 GBK 无效 - 正确方式：逐项检测并转码，
mb_detect_encoding($name, ['GBK', 'UTF-8']) === 'GBK' ? mb_convert_encoding($name, 'UTF-8', 'GBK') : $name - 更可靠的是绕过编码猜测，直接按预期编码转换：
mb_convert_encoding($name, 'UTF-8', 'GBK')（Windows 下几乎总是有效）
