PHP 判斷伺服器作業系統類型：跨平台部署的實用技巧

開發環境（Windows）與生產環境往往不同，程式碼需根據作業系統動態調整路徑分隔符、指令執行、擴充套件載入等邏輯。PHP 提供多種內建常數與函式可偵測 OS 類型，本文整理最可靠的判斷方法與實用程式碼片段。

核心判斷依據：預定義常數

最簡單可靠的判斷邏輯

方法一：檢查 PATH_SEPARATOR（推薦，無函式呼叫開銷）

<?php
if (PATH_SEPARATOR === ':') {
    echo 'Linux/Unix 環境';
} else {
    echo 'Windows 環境';
}
?>

方法二：檢查 PHP_OS 前綴（標準作法）

<?php
// 取得前 3 字元並轉大寫比對
if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
    echo 'This is a server using Windows!';
} else {
    echo 'This is a server NOT using Windows!';
}

// 完整輸出範例
echo php_uname();  // 例：Linux localhost 2.4.21-0.13mdk #1 Fri Mar 14 15:08:06 EST 2003 i686
echo PHP_OS;       // 例：Linux / WINNT
?>

方法三：使用 DIRECTORY_SEPARATOR 區分（直觀）

<?php
define('DS', DIRECTORY_SEPARATOR);
$path = 'var' . DS . 'www' . DS . 'html';  // 自動適應平台分隔符
?>

實際應用場景

• 設定檔路徑動態切換：

  $configPath = (strtoupper(substr(PHP_OS,0,3)) === 'WIN')
      ? 'C:/config/app.ini'
      : '/etc/app/app.ini';

• 外部指令執行：

  $cmd = (PHP_OS === 'WINNT') ? 'dir' : 'ls -la';
  exec($cmd, $output);

• 載入平台專屬擴充套件：

  dl(PHP_SHLIB_SUFFIX === 'dll' ? 'php_xdebug.dll' : 'xdebug.so');

避坑指南

• 不要用 strpos($_SERVER['SERVER_SOFTWARE'], 'Win')：$_SERVER 依賴 Web 伺服器提供，CLI 模式下不可用。
• PHP_OS 為編譯時期常數：跨平台複製二進位檔（如 php.exe）時會保留原編譯平台標識，但 PHP 腳本本身可攜性不受影響。
• Windows 子系統 (WSL) 回傳 Linux：在 WSL 執行的 PHP 會回傳 Linux，符合實際執行環境。

掌握 PHP_OS、PATH_SEPARATOR、DIRECTORY_SEPARATOR 三大關鍵常數，即可輕鬆編寫跨平台相容的 PHP 程式碼，消除「本機測試正常、上線報錯」的部署困擾。