PHP函数pathinfo处理中文路径，UTF-8兼容实测【文件路径】-php教程-PHP中文网

pathinfo()在windows上处理中文路径必须设置正确locale，否则dirname丢中文、basename截断或为空；根本原因是其按字节扫描分隔符，多字节字符字节值易与0x5c/0x2f冲突，导致静默错误。

php函数pathinfo处理中文路径，utf-8兼容实测【文件路径】

pathinfo() 在 Windows 上处理中文路径时，不设 locale 就直接用，大概率出错 —— dirname 丢中文、basename 截断、甚至返回空字符串，这不是 bug，是它本来就这样设计的。

Windows 下 pathinfo() 解析中文路径失败的典型现象

你在 Windows（比如 Win10 + PHP 7.4）中执行：

$path = 'D:	emp项目测试ceshia07.webp';
print_r(pathinfo($path));

得到的 [dirname] 很可能是 D: emp，而不是预期的 D: emp项目测试；[basename] 可能变成乱码或空。根本原因不是 PHP 版本低，而是：pathinfo() 是 locale-aware 函数，它内部按字节扫描或 /，而中文 GBK/UTF-8 多字节字符的某个字节恰好等于 0x5c（反斜杠）或 0x2f（正斜杠），导致提前截断。

现象只在 Windows 常见，因为默认用分隔符，且系统 locale 常为 Chinese (Simplified)_China.936（GBK）
Linux 下多数用 UTF-8 locale，默认行为更稳定，但不代表绝对安全
即使你传的是 UTF-8 编码路径，若系统没装 zh_CN.UTF-8 locale 或没启用，setlocale(LC_ALL, 'zh_CN.UTF-8') 会返回 false，等于白设

setlocale() 必须生效，否则一切白搭

别只写 setlocale(LC_ALL, 'zh_CN.UTF-8') 就完事。先确认系统是否真支持这个 locale：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

// 检查当前 locale
echo setlocale(LC_ALL, 0); // 输出类似 LC_CTYPE=C

// 尝试设置并验证返回值
if (false === setlocale(LC_ALL, 'zh_CN.UTF-8')) {
    echo "locale zh_CN.UTF-8 未安装或名称错误";
}

// 正确的 locale 名称格式（注意：无连字符，.UTF8 不带 '-'）
// 常见有效值：'zh_CN.UTF-8'、'Chinese_China.936'、'en_US.UTF-8'

Windows 下常用 Chinese_China.936（对应 GBK），不是 zh_CN.UTF-8 —— 后者在 Windows 原生支持极弱
Linux 下用 locale -a | grep zh_CN 查看已安装 locale，没结果就需 sudo apt install language-pack-zh-hans（Ubuntu）或等效命令
setlocale() 是进程级全局设置，在多线程 Web Server（如 Apache on Windows、IIS）中可能被其他请求覆盖，不能依赖“设一次永久生效”

更稳妥的替代方案：绕过 locale 依赖的自定义解析

如果你无法控制服务器 locale，或需要跨平台一致行为，直接用字符串操作代替 pathinfo() 更可靠：

function safe_pathinfo($path) {
    $path = str_replace('\', '/', $path); // 统一分隔符
    $dir = dirname($path);
    $base = basename($path);
    $ext = pathinfo($path, PATHINFO_EXTENSION);
    $name = $ext ? substr($base, 0, -(strlen($ext) + 1)) : $base;
    return compact('dir', 'base', 'ext', 'name');
}

// 使用示例
$result = safe_pathinfo('D:/temp/项目/测试/ceshia07.webp');
// $result['dir'] === 'D:/temp/项目/测试'

不依赖 locale，纯 UTF-8 字符串处理，dirname() 和 basename() 在 PHP 中对 UTF-8 路径本身是安全的（只要分隔符统一）
避免使用 pathinfo($path, PATHINFO_FILENAME) —— 它和 PATHINFO_EXTENSION 共享逻辑，仍受 locale 影响
注意：此法不处理 .. 或 . 归一化，如需防御路径遍历，应额外调用 realpath() 或白名单校验

文件上传场景下 pathinfo() 的隐藏风险

很多人用 pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION) 做扩展名白名单校验，却忽略：当 locale 错误时，PATHINFO_EXTENSION 可能返回空，或把 shell.php 错判成 .php，而 PATHINFO_BASENAME 可能漏掉前面的 ../ —— 这不是理论风险，是真实可利用的路径遍历漏洞。

永远不要只靠 pathinfo() 来“净化”用户输入路径
扩展名校验必须结合 mb_strtolower() 和严格白名单（如 in_array($ext, ['jpg','png','pdf'], true)）
保存文件前务必用 basename() 提取最终文件名，并手动过滤 .、/、等危险字符

真正麻烦的从来不是怎么让 pathinfo() 支持中文，而是它在 locale 错误时既不报错也不警告，静默返回错误结果 —— 这种“看起来正常”的失效，最容易在上线后突然暴露问题。