PHP 獲取作業系統類型完整指南：伺服器端常量 vs 客戶端 User-Agent 解析

PHP 獲取作業系統類型完整指南：伺服器端常量 vs 客戶端 User-Agent 解析

PHP 專案中常需根據作業系統調整行為 (如路徑分隔符、指令執行、相容性處理)。獲取 OS 類型分為兩種截然不同場景：伺服器端 (PHP 執行環境) 與 客戶端 (瀏覽器/用戶裝置)。本文詳解兩種場景的標準做法、陷阱與最佳實踐。

一、伺服器端 OS 偵測：PHP 內建常量與函數

PHP 在編譯/啟動時即確定執行環境 OS，提供極高效能的存取方式：

1. PHP_OS 常量 (推薦)

• 編譯期常量，字串值，如 "Linux", "WINNT", "Darwin", "FreeBSD"。
• 無函數呼叫開銷，效能最高。
• 注意：Windows 系統回傳 "WINNT" (含 Vista/7/10/11)，非 "Windows"。判斷邏輯建議用 strtoupper(substr(PHP_OS, 0, 3)) === 'WIN'。

2. php_uname('s') 函數

• 執行期呼叫，參數 's' 回傳作業系統名稱 (同 PHP_OS)。
• 支援其他參數：'n' (主機名), 'r' (釋出版本), 'v' (版本資訊), 'm' (機器類型), 'a' (全部)。
• 跨平台一致性略優於常量 (某些舊版本/特殊編譯環境下)。

常見回傳值對照表

最佳實踐：封裝跨平台路徑/指令工具類

class OS {
    public static function isWindows(): bool {
        return strtoupper(substr(PHP_OS, 0, 3)) === 'WIN';
    }
    public static function isLinux(): bool {
        return PHP_OS === 'Linux';
    }
    public static function isMac(): bool {
        return PHP_OS === 'Darwin';
    }
    public static function getPathSeparator(): string {
        return self::isWindows() ? '\\' : '/';
    }
    public static function getCommandPrefix(): string {
        return self::isWindows() ? 'cmd /c ' : '';
    }
}
// 使用範例
$logPath = __DIR__ . OS::getPathSeparator() . 'logs';
$cmd = OS::getCommandPrefix() . 'php artisan schedule:run';

二、客戶端 OS 偵測：解析 User-Agent (UA) 字串

客戶端 OS 資訊包含在 HTTP 請求 Header User-Agent 中。核心挑戰：UA 字串極其龐雜、可偽造、格式無標準、移動裝置碎片化嚴重。

1. 原生解析邏輯 (教學用，勿生產使用)

原文提供的函數使用已棄用的 eregi() (PHP 7 移除)，且邏輯僅覆蓋極少數桌面 OS，完全無法識別 Android, iOS, Windows Phone, 平板, 智慧電視, 爬蟲, 物聯網裝置。程式碼已過時，僅供理解原理參考。

2. 生產環境標準方案：成熟 UA 解析庫

請勿手寫正則解析 UA。使用 Composer 引入業界標準庫：

3. 實戰範例

// jenssegers/agent (推薦)
use Jenssegers\Agent\Agent;

$agent = new Agent();
$agent->setUserAgent($_SERVER['HTTP_USER_AGENT'] ?? '');

if ($agent->isDesktop()) {
    $os = $agent->platform(); // Windows, macOS, Linux, Ubuntu, Chrome OS...
} elseif ($agent->isMobile()) {
    $os = $agent->platform(); // Android, iOS, BlackBerry...
} elseif ($agent->isTablet()) {
    $os = $agent->platform(); // iPadOS, Android...
} elseif ($agent->isRobot()) {
    $os = 'Bot: ' . $agent->robot();
}

// 獲取完整資訊
$browser = $agent->browser();      // Chrome, Firefox, Safari...
$version = $agent->version($browser);
$device  = $agent->device();       // iPhone, iPad, Samsung Galaxy...
$lang    = $agent->languages();    // ['zh-TW', 'en-US', ...]

三、場景選擇決策樹

1. 需求：調整伺服器端路徑、執行 Shell 指令、載入平台相關擴展 → 使用 PHP_OS / php_uname()。
2. 需求：統計用戶裝置分佈、針對性推送下載連結、適配響應式佈局、風控識別模擬器 → 使用 UA 解析庫 (jenssegers/agent) 解析 $_SERVER['HTTP_USER_AGENT']。
3. 需求：前端 CSS/JS 適配 → 優先使用 CSS Media Queries / JS navigator.userAgentData (User-Agent Client Hints API)，後端僅作備援。

四、安全與隱私提醒

• UA 可被用戶/代理軟體任意修改，**不可用於權限控制或安全決策** (如「是 Windows 才允許登入」)。
• GDPR/個資法下，UA 屬個人資料，**記錄分析需告知同意，避免記錄完整 UA 至日誌**。
• 現代瀏覽器推行 User-Agent Client Hints (UA-CH)，逐步凍結 UA 字串，未來應遷移至 Sec-CH-UA-* Header。

總結

伺服器端 OS 偵測用 PHP_OS (高效、可靠)；客戶端 OS 偵測**棄用手寫正則**，引入 jenssegers/agent 等標準庫，並認清 UA 可偽造、隱私敏感、標準演進的現實。正確分離兩種場景，是構建健壯跨平台 PHP 應用的關鍵。