萬盛學電腦網

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

PHP 偵測行動裝置與桌面裝置:User-Agent 解析完整方案

根據 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 版本),建議使用成熟解析庫:

  • Mobile_Detect(PHP,輕量、佔星級高):composer require detection/mobile-detect
  • UAParser(PHP,基於 ua-parser 規則庫):composer require ua-parser/uaparser
  • WhichBrowser:更詳細的瀏覽器/引擎/裝置解析

Mobile_Detect 使用範例

<?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";
}

響應式設計 vs 伺服器端導向

現代最佳實踐:優先採用 CSS 響應式設計(Media Queries、Flex/Grid),而非伺服器端 UA 導向。

UA 偵測的缺點:

  • UA 字串易偽造、格式不標準、新裝置不斷出現
  • 維護關鍵字清單成本高,易漏判/誤判
  • 響應式設計一次開發、多裝置適配,SEO 友善(單一 URL)

仍需 UA 導向的場景:

  • 舊系統無法重構為響應式
  • 行動版與桌面版功能差異極大(如 App 下載頁)
  • 廣告投放、統計分析需精確裝置屬性

快取與效能

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";
copyright © 萬盛學電腦網 all rights reserved