萬盛學電腦網

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

PHP 依瀏覽器 Accept-Language 標頭自動偵測語言並導向對應版本

Accept-Language 標頭格式

Accept-Language: zh-TW,zh;q=0.9,en-US;q=0.8,en;q=0.7

格式:語言代碼[-地區],可選 q=權重 (0~1),預設 1。瀏覽器按偏好排序。

解析並選擇最佳匹配

<?php
function negotiateLanguage(array $supported = ['zh-TW', 'zh-CN', 'en-US', 'en']): string
{
    $header = $_SERVER['HTTP_ACCEPT_LANGUAGE'] ?? '';
    if (!$header) return $supported[0]; // 預設第一個

    // 解析語言標籤與權重
    $langs = [];
    foreach (explode(',', $header) as $part) {
        $part = trim($part);
        $q = 1.0;
        if (preg_match('/(.*);\s*q=([0-9.]+)/', $part, $m)) {
            $part = $m[1];
            $q = (float)$m[2];
        }
        $tag = strtolower($part);
        $langs[$tag] = max($langs[$tag] ?? 0, $q); // 同語言取最高權重
    }
    arsort($langs); // 權重降冪

    // 匹配支援語言 (精確 > 語言碼前綴)
    foreach ($langs as $acceptLang => $q) {
        // 1. 精確匹配
        if (in_array($acceptLang, $supported, true)) return $acceptLang;
        // 2. 語言碼前綴匹配 (zh-TW -> zh)
        $primary = explode('-', $acceptLang)[0];
        foreach ($supported as $sup) {
            if (str_starts_with(strtolower($sup), $primary . '-')) return $sup;
        }
        if (in_array($primary, $supported, true)) return $primary;
    }
    return $supported[0]; // 回退預設
}

// 使用
$lang = negotiateLanguage(['zh-TW', 'en-US', 'ja-JP']);
header("Location: /$lang/");
exit;

整合到前端控制器

<?php
// public/index.php 或前端控制器
session_start();

$supported = ['zh-TW', 'zh-CN', 'en-US', 'ja-JP', 'ko-KR'];
$default   = 'zh-TW';

// 1. 明確切換 (最高優先)
if (isset($_GET['lang']) && in_array($_GET['lang'], $supported, true)) {
    $_SESSION['lang'] = $_GET['lang'];
    header('Location: ' . strtok($_SERVER['REQUEST_URI'], '?'));
    exit;
}

// 2. Session 記憶
if (isset($_SESSION['lang']) && in_array($_SESSION['lang'], $supported, true)) {
    $lang = $_SESSION['lang'];
}
// 3. 瀏覽器偏好協商
else {
    $lang = negotiateLanguage($supported);
    $_SESSION['lang'] = $lang;
}

// 4. 載入語言檔
require __DIR__ . "/lang/$lang.php"; // 回傳陣列 $lang = ['welcome'=>'歡迎', ...]
?>

現代化:Symfony HttpFoundation Locale Negotiator

composer require symfony/http-foundation

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Locale\LocaleNegotiator;

$request = Request::createFromGlobals();
$negotiator = new LocaleNegotiator();
$locale = $negotiator->getLocale($request, ['zh_TW', 'en_US', 'ja_JP']); // 回傳最佳匹配
// 自動處理 q 值、地區回退、快取

SEO 與快取注意

  • 不同語言**必須有不同 URL** (如 /zh-TW/, /en-US/),不可只靠 Cookie/Session 切換同一 URL
  • 回應加上 Vary: Accept-Language,讓 CDN/Proxy 正確快取
  • hreflang 標籤告知搜尋引擎多語言版本
copyright © 萬盛學電腦網 all rights reserved