萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 根据 HTTP_ACCEPT_LANGUAGE 自动检测用户首选语言

场景介绍

多语言网站常需根据浏览器发送的 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
?>

关键逻辑解析

  1. 正则拆解:捕获语言标签([a-z]{1,8}(-[a-z]{1,8})?)、可选 q 值(q=0.9)
  2. 默认 q=1:未显式指定 q 值的语言视为最高优先级
  3. 数值排序:arsort($langs, SORT_NUMERIC) 确保高 q 值在前
  4. 降级处理:提取主语言代码(去除地区后缀),便于匹配项目语言包

集成建议

  • 在框架入口(如 index.php 或中间件)调用,将结果存入 Session/Cookie
  • 配合语言包数组 ['zh' => '中文', 'en' => 'English'] 做兜底校验
  • 提供手动切换语言入口,覆盖自动检测结果,尊重用户显式选择

常见 Accept-Language 示例

// 中文用户典型头
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+,无外部依赖,可直接复制到项目工具库中使用。

copyright © 萬盛學電腦網 all rights reserved