ThinkPHP语言白名单用于防止非法语言标识导致安全问题,需开发者主动定义并校验;推荐在自定义中间件中统一处理,从请求获取参数、严格校验(转小写后比对配置的allow_langs)、设置Locale并重载语言包。

ThinkPHP 设置语言白名单数组,核心目的是防止非法语言标识(如 ../etc/passwd、zh_CN、ja)被传入导致目录遍历、加载失败或静默降级。它不依赖框架自动识别,必须由开发者主动定义并校验。
在中间件中定义并校验白名单
推荐在自定义语言中间件(如 app/middleware/LangCheck.php)中统一处理,确保在任何翻译调用前完成校验和设置:
- 从请求中安全获取语言参数,例如:
$lang = $request->input('lang', '') ?: $request->header('accept-language', 'zh-cn'); - 预设可信语言标识数组,全部小写、连字符格式:
$whitelist = ['zh-cn', 'en-us', 'ja-jp', 'ko-kr']; - 严格校验:
if (!in_array(strtolower($lang), $whitelist)) { $lang = 'zh-cn'; }(注意:必须用strtolower()统一处理,避免大小写绕过) - 设置生效:
\think\Lang::setLocale($lang);,随后调用\think\Lang::load();确保语言包重载
从配置文件读取白名单(更灵活可维护)
把白名单移到配置中,便于多环境管理。在 config/app.php 或单独新建 config/lang.php:
'allow_langs' => ['zh-cn', 'en-us', 'ja-jp']
中间件中改为:
立即学习“PHP免费学习笔记(深入)”;
$whitelist = config('lang.allow_langs', ['zh-cn']);- 后续校验逻辑不变,但支持热更新、环境差异化配置
字段名与格式必须严格匹配
白名单数组中的每一项,必须完全符合 ThinkPHP 的语言包路径规范:
- 全小写,仅含字母、短横线(
-),无下划线、大写字母或点号;zh_CN、en_US、zh均无效 - 需与实际语言包目录名一致:白名单含
ja-jp,则必须存在app/lang/ja-jp/common.php - 建议在应用启动时做一次校验,比如在
app/common.php中检查app/lang/下是否存在对应子目录,避免上线后才发现缺失
不要依赖 URL 参数自动解析
ThinkPHP 的 Lang 中间件默认不解析 ?lang=xxx,也不校验其合法性。若需支持链接带参切换,必须手动提取 + 白名单校验 + setLocale,不能跳过这三步。直接将 input('lang') 结果传给 setLocale 是典型安全隐患。



















