Windows Server 2003 + IIS + PHP 環境變數讀取失敗：根因分析與三種解決方案

在 Windows Server 2003 上整合 PHP 與 IIS 時，常遇到 phpinfo() 顯示正常但環境變數（如 PHPRC、PATH）不生效、擴展庫載入失敗、MySQL 連線異常等問題。本文系統梳理故障排查邏輯與解決方案。

核心診斷步驟：確認實際生效的 php.ini

瀏覽 phpinfo() 頁面，檢查 Configuration File (php.ini) Path 與 Loaded Configuration File 兩欄位：

• 若顯示 C:\Windows → PHP 讀取的是系統目錄下的 php.ini，而非你修改的版本。
• 若 extension_dir 指向錯誤路徑 → 擴展庫無法載入。

php.ini 搜尋優先順序（Windows）

1. SAPI 模組指定位置（Apache PHPIniDir、CLI -c 參數）
2. 註冊表 HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath
3. 環境變數 PHPRC
4. 當前工作目錄（CLI）
5. Web 伺服器目錄（SAPI）或 PHP 安裝目錄
6. Windows 目錄（C:\Windows）或編譯時 --with-config-file-path 指定路徑

三大常見故障與解決方案

故障一：修改 php.ini 不生效

原因：讀取的非預期 php.ini，或未完全重啟 IIS。

解決：

1. 在「系統環境變數」新增 PHPRC=C:\php（指向 php.ini 所在目錄）。
2. 完全重啟 IIS：CMD 執行 net stop iisadmin && net start w3svc，單站點重啟無效。
3. 確認 phpinfo() 顯示的 Loaded Configuration File 已更新。

故障二：擴展庫載入失敗（以 php_mysql.dll 為例）

雙重條件：

1. php.ini 啟用 extension=php_mysql.dll
2. 系統 PATH 包含 libmysql.dll 所在目錄

最佳實踐：將 PHP 安裝目錄（如 C:\php）加入系統 PATH，而非複製 libmysql.dll 到 System32（易造成版本衝突、鎖定無法更新）。

故障三：ISAPI 模式下環境變數不生效

根因：ISAPI 以系統服務身份執行，不繼承用戶級環境變數，導致 PHPRC 無法讀取。

解決方案對比：

強烈建議遷移至 FastCGI：效能更優、隔離性更好、環境變數完整生效、支援 PHP 進程池管理。

MySQL 擴展啟用檢查清單

1. php.ini：extension=php_mysql.dll、extension_dir="C:\php\ext"
2. 系統 PATH 包含 C:\php（含 libmysql.dll）
3. 完全重啟 IIS（iisreset 或 net stop/start）
4. phpinfo() 驗證 mysql 區塊出現，Client API version 顯示正常

Windows + IIS + PHP 部署的核心原則：統一配置來源、環境變數系統級設定、FastCGI 取代 ISAPI、擴展依賴走 PATH 而非複製檔案。