根據 User-Agent 判斷裝置類型是常見需求,適用於響應式導向、統計分析、廣告投放等場景。本文提供可直接使用的檢測函數,涵蓋主流作業系統、瀏覽器特徵與螢幕尺寸特徵碼。
<?php
/**
* 判斷是否為行動裝置
* @return bool true=行動裝置, false=桌面裝置
*/
function isMobile(): bool {
$ua = $_SERVER['HTTP_USER_AGENT'] ?? '';
// 1. 快速排除:常見桌面瀏覽器關鍵字
$desktopPatterns = [
'Windows NT', 'Macintosh', 'X11', 'Linux x86_64', 'CrOS',
'Bot', 'Crawler', 'Spider', 'Slurp', 'Baiduspider', 'Googlebot',
];
foreach ($desktopPatterns as $pattern) {
if (stripos($ua, $pattern) !== false) return false;
}
// 2. 行動裝置作業系統關鍵字
$mobileOS = [
'Android', 'iPhone', 'iPod', 'iPad', 'Windows Phone',
'BlackBerry', 'BB10', 'Symbian', 'Tizen', 'webOS',
'Kindle', 'Silk', 'PlayBook', 'Meego', 'Sailfish',
];
// 3. 行動裝置瀏覽器/裝置特徵碼
$mobileTokens = [
'Mobile', 'Tablet', 'Mobi', 'Mini', 'Fennec',
'Opera Mobi', 'Opera Mini', 'UCBrowser', 'MQQBrowser',
'MicroMessenger', 'MiuiBrowser', 'HuaweiBrowser',
'SamsungBrowser', 'VivoBrowser', 'OPPOBrowser',
'wv', // Android WebView
];
// 4. 螢幕尺寸特徵碼(舊版功能機常見)
$screenPatterns = [
'160×160', '176×220', '240×240', '240×320',
'320×240', '320×480', '480×800', '720×1280',
];
$check = function (array $patterns) use ($ua) {
foreach ($patterns as $p) {
if (stripos($ua, $p) !== false) return true;
}
return false;
};
return $check($mobileOS) || $check($mobileTokens) || $check($screenPatterns);
}
// 使用範例
if (isMobile()) {
echo '行動裝置訪問 → 導向 m.example.com';
// header('Location: https://m.example.com');
} else {
echo '桌面裝置訪問 → 顯示完整版';
// header('Location: https://www.example.com');
}
若需更豐富資訊(品牌、型號、OS 版本),建議使用成熟解析庫:
composer require detection/mobile-detectcomposer require ua-parser/uaparser<?php
require_once 'vendor/autoload.php';
$detect = new Detection\MobileDetect();
if ($detect->isMobile()) {
echo "行動裝置";
if ($detect->isiOS()) echo " (iOS)";
elseif ($detect->isAndroidOS()) echo " (Android)";
if ($detect->isTablet()) echo " 平板";
if ($detect->is('iPhone')) echo " iPhone";
}
現代最佳實踐:優先採用 CSS 響應式設計(Media Queries、Flex/Grid),而非伺服器端 UA 導向。
UA 偵測的缺點:
仍需 UA 導向的場景:
UA 解析結果可快取(Key: UA 字串哈希),避免重複解析。Nginx 層面可用 map 指令預判裝置類型並設定快取 Key:
map $http_user_agent $device_type {
default "desktop";
"~*Mobile" "mobile";
"~*Tablet" "tablet";
}
proxy_cache_key "$scheme$host$request_uri$device_type";