多语言网站常需根据浏览器发送的 Accept-Language 头自动判断用户偏好语言,实现无感切换。本文提供一个健壮的 getPreferredLanguage() 函数,解析质量因子(q-value),按优先级返回最匹配的语言代码(如 zh、en、ja)。
<?php
/**
* 解析 $_SERVER['HTTP_ACCEPT_LANGUAGE'] 返回最高优先级语言代码
*
* @return string 语言代码(如 zh、en、ja),解析失败返回空字符串
*/
function getPreferredLanguage(): string {
$langs = [];
if (isset($_SERVER['HTTP_ACCEPT_LANGUAGE'])) {
// 正则拆解:语言标签、可选地区、可选 q 值
// 例: "zh-CN,zh;q=0.9,en;q=0.8,en-US;q=0.7"
preg_match_all(
'/([a-z]{1,8}(-[a-z]{1,8})?)\s*(;\s*q\s*=\s*(1|0\.[0-9]+))?/i',
$_SERVER['HTTP_ACCEPT_LANGUAGE'],
$langParse
);
if (count($langParse[1])) {
// 组合:语言标签 => q 值(默认 1)
$langs = array_combine($langParse[1], $langParse[4]);
foreach ($langs as $lang => $val) {
if ($val === '') $langs[$lang] = 1.0;
}
// 按 q 值降序排序
arsort($langs, SORT_NUMERIC);
}
}
// 取第一个(优先级最高)
foreach ($langs as $lang => $val) {
// 简化:若含地区码(如 zh-CN),仅保留主语言 zh
if (strpos($lang, '-') !== false) {
$lang = explode('-', $lang)[0];
}
return strtolower($lang);
}
return ''; // 无法解析时返回空
}
// 使用示例
// 假设浏览器发送: Accept-Language: zh-CN,zh;q=0.9,en;q=0.8
echo getPreferredLanguage(); // 输出: zh
?>
[a-z]{1,8}(-[a-z]{1,8})?)、可选 q 值(q=0.9)arsort($langs, SORT_NUMERIC) 确保高 q 值在前index.php 或中间件)调用,将结果存入 Session/Cookie['zh' => '中文', 'en' => 'English'] 做兜底校验// 中文用户典型头
zh-CN,zh;q=0.9,en;q=0.8,en-US;q=0.7
// 返回 'zh'
// 英文用户典型头
en-US,en;q=0.9,zh-CN;q=0.8
// 返回 'en'
// 无头或异常
// 返回 '',建议回退到站点默认语言
该函数兼容 PHP 7.1+,无外部依赖,可直接复制到项目工具库中使用。