萬盛學電腦網

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

PHP 瀏覽器檢測完整指南:User-Agent 解析、裝置識別、機器人識別與現代替代方案

前言

透過 $_SERVER['HTTP_USER_AGENT'] 檢測瀏覽器類型、版本、作業系統、裝置類型是常見需求 (相容性處理、分析統計、機器人過濾)。但 User-Agent 字串極其混亂、可偽造、格式無標準。本文提供穩健解析策略、現代替代方案 (Client Hints)、完整實作範例與維護建議。

一、User-Agent 基礎知識

典型 UA 字串結構

Mozilla/5.0 (平台; 加密; 作業系統/版本) 引擎/版本 瀏覽器/版本 (附加資訊)

例:Chrome on Windows
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36

例:iPhone Safari
Mozilla/5.0 (iPhone; CPU iPhone OS 17_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2 Mobile/15E148 Safari/604.1

例:Googlebot
Mozilla/5.0 (compatible; Googlebot/2.1; +https://www.google.com/bot.html)

關鍵特徵

  • 幾乎所有瀏覽器以 Mozilla/5.0 開頭 (歷史相容)
  • 關鍵識別 token:Chrome/, Firefox/, Safari/, Edge/, MSIE , Trident/ (IE11)
  • 行動裝置常含 Mobile, Android, iPhone, iPad
  • 機器人常含 bot, crawler, spider, Googlebot, bingbot

二、原生 PHP 解析策略 (輕量、無依賴)

1. 瀏覽器識別函數 (優先序很重要!)

<?php
function detectBrowser(string $ua = ''): array {
    $ua = $ua ?: ($_SERVER['HTTP_USER_AGENT'] ?? '');
    $uaLower = strtolower($ua);
    
    $result = [
        'browser' => 'Unknown',
        'version' => 'Unknown',
        'engine' => 'Unknown',
        'os' => 'Unknown',
        'device' => 'Desktop', // Desktop / Mobile / Tablet / Bot
        'is_bot' => false,
    ];
    
    // 1. 機器人優先判斷 (避免被誤判為瀏覽器)
    $bots = [
        'Googlebot' => 'Googlebot', 'bingbot' => 'Bingbot', 'Slurp' => 'Yahoo Slurp',
        'DuckDuckBot' => 'DuckDuckBot', 'Baiduspider' => 'Baiduspider', 'YandexBot' => 'YandexBot',
        'facebookexternalhit' => 'Facebook Bot', 'Twitterbot' => 'Twitter Bot',
        'bot' => 'Generic Bot', 'crawler' => 'Crawler', 'spider' => 'Spider',
    ];
    foreach ($bots as $token => $name) {
        if (stripos($ua, $token) !== false) {
            $result['browser'] = $name;
            $result['is_bot'] = true;
            $result['device'] = 'Bot';
            // 嘗試提取版本
            if (preg_match('/' . preg_quote($token, '/') . '\/([\d.]+)/i', $ua, $m)) {
                $result['version'] = $m[1];
            }
            return $result;
        }
    }
    
    // 2. 作業系統判斷
    $osPatterns = [
        '/Windows NT 10\.0/' => 'Windows 10/11',
        '/Windows NT 6\.3/' => 'Windows 8.1',
        '/Windows NT 6\.2/' => 'Windows 8',
        '/Windows NT 6\.1/' => 'Windows 7',
        '/Windows NT 6\.0/' => 'Windows Vista',
        '/Windows NT 5\.1/' => 'Windows XP',
        '/Mac OS X ([\d_]+)/' => 'macOS $1', // 需 preg_match 提取
        '/iPhone OS ([\d_]+)/' => 'iOS $1',
        '/iPad.*OS ([\d_]+)/' => 'iPadOS $1',
        '/Android ([\d.]+)/' => 'Android $1',
        '/Linux/ ' => 'Linux',
        '/CrOS/ ' => 'Chrome OS',
    ];
    foreach ($osPatterns as $pattern => $name) {
        if (preg_match($pattern, $ua, $m)) {
            $result['os'] = is_array($m) ? str_replace('_', '.', $m[1]) : $name;
            break;
        }
    }
    
    // 3. 裝置類型
    if (stripos($ua, 'Mobile') !== false && stripos($ua, 'iPad') === false) {
        $result['device'] = 'Mobile';
    } elseif (stripos($ua, 'Tablet') !== false || stripos($ua, 'iPad') !== false) {
        $result['device'] = 'Tablet';
    }
    
    // 4. 瀏覽器引擎與名稱 (順序關鍵:Edge/Chrome/Safari/Firefox/IE)
    // Edge (Chromium) 含 Chrome token,必須優先檢查
    if (preg_match('/Edg\/([\d.]+)/', $ua, $m)) { // Edge 79+
        $result['browser'] = 'Edge';
        $result['version'] = $m[1];
        $result['engine'] = 'Blink';
    } elseif (preg_match('/Chrome\/([\d.]+)/', $ua, $m) && stripos($ua, 'Edg') === false && stripos($ua, 'OPR') === false && stripos($ua, 'Brave') === false && stripos($ua, 'Vivaldi') === false) {
        $result['browser'] = 'Chrome';
        $result['version'] = $m[1];
        $result['engine'] = 'Blink';
    } elseif (preg_match('/Firefox\/([\d.]+)/', $ua, $m)) {
        $result['browser'] = 'Firefox';
        $result['version'] = $m[1];
        $result['engine'] = 'Gecko';
    } elseif (preg_match('/Version\/([\d.]+).*Safari/', $ua, $m) && stripos($ua, 'Chrome') === false && stripos($ua, 'CriOS') === false && stripos($ua, 'FxiOS') === false) {
        $result['browser'] = 'Safari';
        $result['version'] = $m[1];
        $result['engine'] = 'WebKit';
    } elseif (preg_match('/MSIE ([\d.]+)/', $ua, $m) || preg_match('/Trident\/.*rv:([\d.]+)/', $ua, $m)) {
        $result['browser'] = 'Internet Explorer';
        $result['version'] = $m[1];
        $result['engine'] = 'Trident';
    } elseif (preg_match('/OPR\/([\d.]+)/', $ua, $m) || preg_match('/Opera\/([\d.]+)/', $ua, $m)) {
        $result['browser'] = 'Opera';
        $result['version'] = $m[1];
        $result['engine'] = 'Blink';
    } elseif (preg_match('/Brave\/([\d.]+)/', $ua, $m)) {
        $result['browser'] = 'Brave';
        $result['version'] = $m[1];
        $result['engine'] = 'Blink';
    } elseif (preg_match('/Vivaldi\/([\d.]+)/', $ua, $m)) {
        $result['browser'] = 'Vivaldi';
        $result['version'] = $m[1];
        $result['engine'] = 'Blink';
    }
    
    return $result;
}

// 使用
$info = detectBrowser();
echo "Browser: {$info['browser']} {$info['version']} | OS: {$info['os']} | Device: {$info['device']} | Bot: " . ($info['is_bot'] ? 'Yes' : 'No');
?>

三、現代標準:Client Hints (CH)

User-Agent 字串凍結/簡化趨勢 (Google UA Reduction)。Client Hints 提供結構化、標準化、可控的裝置/瀏覽器資訊。

啟用方式 (需 HTTPS)

<!-- HTML meta tag 或 HTTP Header -->
<meta http-equiv="Accept-CH" content="Sec-CH-UA, Sec-CH-UA-Mobile, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version, Sec-CH-UA-Model">

<?php
// PHP 讀取 Client Hints Headers
$secChUa = $_SERVER['HTTP_SEC_CH_UA'] ?? '';           // "Chromium";v="120", "Google Chrome";v="120", "Not=A?Brand";v="24"
$secChUaMobile = $_SERVER['HTTP_SEC_CH_UA_MOBILE'] ?? ''; // ?1 : ?0
$secChUaPlatform = $_SERVER['HTTP_SEC_CH_UA_PLATFORM'] ?? ''; // "Windows", "macOS", "Android", "iOS"
$secChUaPlatformVersion = $_SERVER['HTTP_SEC_CH_UA_PLATFORM_VERSION'] ?? ''; // "15.0"
$secChUaModel = $_SERVER['HTTP_SEC_CH_UA_MODEL'] ?? ''; // "Pixel 7"
?>

Client Hints 解析範例

<?php
function parseClientHints(): array {
    $ua = $_SERVER['HTTP_SEC_CH_UA'] ?? '';
    $mobile = $_SERVER['HTTP_SEC_CH_UA_MOBILE'] ?? '?0';
    $platform = $_SERVER['HTTP_SEC_CH_UA_PLATFORM'] ?? '';
    $platformVer = $_SERVER['HTTP_SEC_CH_UA_PLATFORM_VERSION'] ?? '';
    $model = $_SERVER['HTTP_SEC_CH_UA_MODEL'] ?? '';
    
    // 解析 Sec-CH-UA (結構化列表)
    $brands = [];
    preg_match_all('/"([^"]+)"(?:;v="([^"]+)")?/', $ua, $matches, PREG_SET_ORDER);
    foreach ($matches as $m) {
        $brands[] = ['brand' => $m[1], 'version' => $m[2] ?? ''];
    }
    
    // 判斷主要瀏覽器
    $browser = 'Unknown'; $version = 'Unknown';
    foreach ($brands as $b) {
        if (in_array($b['brand'], ['Google Chrome', 'Chromium', 'Microsoft Edge', 'Brave', 'Vivaldi', 'Opera', 'Firefox', 'Safari'])) {
            $browser = $b['brand'];
            $version = $b['version'];
            break;
        }
    }
    
    return [
        'browser' => $browser,
        'version' => $version,
        'platform' => trim($platform, '"'),
        'platform_version' => trim($platformVer, '"'),
        'model' => trim($model, '"'),
        'is_mobile' => $mobile === '?1',
        'brands' => $brands,
    ];
}
?>

四、生產級方案:使用成熟庫

手寫解析器維護成本極高 (UA 字串不斷變化)。推薦使用:

庫安裝特點
Jenssegers/Agentcomposer require jenssegers/agentLaravel 官方推薦、基於 UA + Client Hints、支援快取、裝置/機器人/語言檢測
Matomo/DeviceDetectorcomposer require device-detector/device-detector最全面、準確、支援 APP/智慧電視/機器人、定期更新規則庫、緩存支援
piwik/device-detector同上 (舊名)同 DeviceDetector

Jenssegers/Agent 使用範例

<?php
require 'vendor/autoload.php';
use Jenssegers\Agent\Agent;

$agent = new Agent();

echo $agent->browser();           // Chrome
echo $agent->browserVersion();    // 120.0.0
echo $agent->platform();          // Windows
echo $agent->platformVersion();   // 10.0
echo $agent->device();            // Desktop / Mobile / Tablet / Robot
echo $agent->robot() ? 'Bot' : 'Human'; // true/false
echo $agent->robotName();         // Googlebot
echo $agent->languages();         // ['zh-TW', 'en-US', 'en']
echo $agent->is('Chrome');        // true
echo $agent->isMobile();          // false
echo $agent->isTablet();          // false
echo $agent->isDesktop();         // true

// 結合 Client Hints (自動)
$agent->setUserAgent($_SERVER['HTTP_USER_AGENT'] ?? '');
$agent->setHttpHeaders($_SERVER); // 自動讀取 Sec-CH-UA*
?>

五、常見應用場景與策略

場景策略注意事項
CSS/JS 相容性回退Modernizr (特性檢測) > UA 判斷特性檢測更可靠、面向未來
行動版/桌面版切換響應式設計 (CSS Media Query) > UA 判斷單一代碼庫、SEO 友善、維護成本低
統計分析 (GA/自建)記錄 UA + Client Hints,離線解析原始資料保留,事後可重新分析
機器人/爬蟲過濾UA 關鍵字 + IP 信譽 + 行為分析 (速率、路徑)UA 易偽造,需多層防禦
特定瀏覽器 Bug 修正最小化 UA 判斷,加註釋、設定過期檢查瀏覽器更新快,硬編碼判斷易過期
廣告/追蹤/指紋Client Hints + JS 指紋 (Canvas, Fonts, AudioContext)隱私法規 (GDPR/CCPA) 需同意

六、安全與隱私提醒

  • UA 可任意偽造:curl -A "Googlebot" url,不可用於授權/安全決策
  • Client Hints 需用戶代理協作:瀏覽器依策略決定是否發送,可能為空
  • 指紋識別涉隱私:GDPR 視為個人資料,需明確同意、透明說明
  • 最小化收集:僅收集業務必要欄位,定期清理

七、總結

  1. 簡單需求:自寫 detectBrowser() 足夠,注意優先序 (Bot > Edge > Chrome > Safari > Firefox > IE)
  2. 生產系統:強烈建議使用 DeviceDetector 或 Jenssegers/Agent,定期 composer update 更新規則庫
  3. 前瞻佈局:部署 Accept-CH 標頭,漸進式遷移至 Client Hints
  4. 架構原則:特性檢測 > Client Hints > UA 解析,避免硬編碼瀏覽器版本判斷
copyright © 萬盛學電腦網 all rights reserved