ThinkPHP多语言目录大小写敏感吗_ThinkPHP多语言路径规范介绍【解答】-ThinkPHP-PHP中文网

thinkphp多语言目录路径本身不区分大小写，但实际加载成败取决于文件系统：linux/macos严格区分，windows不区分；语言包文件名必须与配置值完全一致，推荐统一用小写连字符格式如zh-cn。

thinkphp多语言目录大小写敏感吗_thinkphp多语言路径规范介绍【解答】

ThinkPHP 多语言目录本身不敏感，但实际能否加载成功，取决于文件系统和语言包文件名的大小写匹配程度——Linux 下必须严格一致，Windows 下可宽松。

多语言目录路径是否区分大小写

ThinkPHP 自身对 lang 目录路径（如 app/lang 或 runtime/lang）的解析不做强制大小写校验，它只是按配置拼接路径并尝试读取。真正起决定作用的是底层文件系统：

Linux / macOS 服务器：文件路径严格区分大小写，app/lang/zh-cn.php 和 app/lang/zh-CN.php 是两个不同文件
Windows 开发环境：文件系统不区分大小写，zh-cn、ZH-CN、zh_CN 可能都“碰巧”能加载成功
容器或云环境（如 Docker + Alpine）：默认使用 Linux 内核，同样敏感

所以不是 ThinkPHP “规定”大小写敏感，而是它把路径直接交给 PHP 的 is_file() 和 include 去处理，而这些操作受操作系统约束。

语言包文件名大小写必须与配置值完全一致

ThinkPHP 加载语言包时，会用当前语言标识（如 config('app.default_lang') 或请求头中的 Accept-Language 解析出的值）拼成文件名，例如：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

zh-cn → app/lang/zh-cn.php  
en-us → app/lang/en-us.php  
zh_CN → app/lang/zh_CN.php

如果配置中设了 'default_lang' => 'zh-CN'，但实际只有 zh-cn.php，则加载失败（Linux 下），报错类似：Warning: include(): Failed opening '.../zh-CN.php' for inclusion。

推荐统一使用小写 + 连字符格式：zh-cn、en-us、ja-jp
避免混用下划线（zh_CN）或大写（ZH-CN），尤其不要在配置里写 zh-CN 却放文件为 zh-cn.php
检查 app/lang/ 下的文件名是否与 Lang::getLangSet() 返回值完全一致（可用 var_dump(Lang::getLangSet()) 验证）

URL 中语言参数（如 ?lang=zh-CN）是否敏感

这个跟多语言目录无关，属于路由或参数解析逻辑。ThinkPHP 默认不会自动将 lang 参数映射为语言切换——除非你手动调用 Lang::set() 或启用多语言中间件。

参数值本身是字符串，?lang=zh-cn 和 ?lang=ZH-CN 是两个不同值
如果你在控制器里写 Lang::set(input('lang'))，那它就原样传入，后续加载行为仍取决于该字符串能否匹配到真实存在的语言包文件名
建议在接收参数后做标准化处理，比如统一转小写：Lang::set(strtolower(input('lang')))

ThinkPHP6+ 的多语言驱动路径规则

TP6 使用 think\lang\driver\File 驱动，默认语言路径由 lang_path 配置控制（默认为 app/lang）。该驱动内部用 Loader::parseName() 处理语言标识，但仅用于生成子目录名（如 zh-cn/common.php），并不自动修正大小写。