HOWTO · PHP
如何在 PHP 中偵測行動裝置
瞭解如何使用 Mobile Detect 或使用者代理模式,在 PHP 中將請求分類為行動裝置。
本頁內容
在 PHP 中,您可以使用透過 Composer 安裝的 mobiledetect 函式庫,或以 preg_match() 比對 $_SERVER 中的 HTTP_USER_AGENT,將請求分類為來自行動裝置。這兩種方法都是根據請求標頭推測裝置類別,無法證明發出請求的實際裝置是什麼。
在 PHP 中使用 mobiledetect 類別偵測行動裝置
使用 Composer 將 mobiledetect 函式庫安裝到專案中,指令為 composer require mobiledetect/mobiledetectlib。接著載入 Composer 的 vendor/autoload.php,並建立 Mobile_Detect 執行個體。這個函式庫會根據使用者代理字串及其他標頭等請求資訊來分類用戶端。
若要進行基本的行動裝置檢查,請呼叫 $detect->isMobile()。它會傳回布林值,您可以在 if/else 分支中使用這個值,選擇行動裝置或非行動裝置的結果。如果應用程式需要將平板電腦另外處理,這個類別也提供 isTablet();使用較廣泛的行動裝置分類前,請先決定平板電腦的判定結果應如何影響版面或功能。
這項分類反映的是 PHP 收到的請求。變更模擬裝置時,瀏覽器的回應式設計模式可能會送出不同的使用者代理,但這並不能驗證程式在每一款實體手機或平板電腦上的行為。使用者代理值可以被修改,因此不應將用戶端偵測用於安全性或身分驗證。
在 PHP 中使用 HTTP_USER_AGENT 和 preg_match() 函式偵測行動裝置
若要在不依賴額外函式庫的情況下檢查,可以從 $_SERVER 超級全域變數讀取 HTTP_USER_AGENT,並比對一小組與行動裝置相關的詞彙。這個索引鍵可能不存在,因此呼叫 preg_match() 前,請先提供字串作為預設值。此範例會檢查一個 iPhone 使用者代理字串;在網頁請求中,PHP 會從請求標頭取得該值。
<?php
$_SERVER['HTTP_USER_AGENT'] = 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X)';
$userAgent = $_SERVER['HTTP_USER_AGENT'] ?? '';
$pattern = '/(android|iphone|ipod|ipad|mobile|tablet)/i';
$isMobile = preg_match($pattern, $userAgent) === 1;
echo $isMobile ? 'Mobile device detected' : 'Mobile device not detected';
preg_match() 在符合模式時會傳回 1,不符合時傳回 0,而無法評估模式時則傳回 false。使用 === 1 比較,可讓分支只在比對成功時執行。實際請求若未包含該標頭,預設值會是空字串,因此此模式會進入非行動裝置分支。
請將這個結果視為粗略分類。使用者代理字串可能不存在、遭到修改或有所變動;簡短且手動維護的模式也可能漏掉較新的用戶端或較少見的用戶端。列出更多項目並不代表涵蓋完整。關於行動裝置使用者代理字串的 Stack Overflow 討論由社群維護,採用其中的建議前請仔細評估是否適合您的應用程式。