透過 $_SERVER['HTTP_USER_AGENT'] 檢測瀏覽器類型、版本、作業系統、裝置類型是常見需求 (相容性處理、分析統計、機器人過濾)。但 User-Agent 字串極其混亂、可偽造、格式無標準。本文提供穩健解析策略、現代替代方案 (Client Hints)、完整實作範例與維護建議。
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 開頭 (歷史相容)Chrome/, Firefox/, Safari/, Edge/, MSIE , Trident/ (IE11)Mobile, Android, iPhone, iPadbot, crawler, spider, Googlebot, bingbot<?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');
?>
User-Agent 字串凍結/簡化趨勢 (Google UA Reduction)。Client Hints 提供結構化、標準化、可控的裝置/瀏覽器資訊。
<!-- 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"
?>
<?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/Agent | composer require jenssegers/agent | Laravel 官方推薦、基於 UA + Client Hints、支援快取、裝置/機器人/語言檢測 |
| Matomo/DeviceDetector | composer require device-detector/device-detector | 最全面、準確、支援 APP/智慧電視/機器人、定期更新規則庫、緩存支援 |
| piwik/device-detector | 同上 (舊名) | 同 DeviceDetector |
<?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) 需同意 |
curl -A "Googlebot" url,不可用於授權/安全決策detectBrowser() 足夠,注意優先序 (Bot > Edge > Chrome > Safari > Firefox > IE)composer update 更新規則庫Accept-CH 標頭,漸進式遷移至 Client Hints