在 Windows Server 2003 + IIS 6.0 環境下部署 PHP,雖 phpinfo() 正常顯示,但環境變量(如 PHPRC、PATH)無法生效,導致 php.ini 未加載、擴展庫未找到、MySQL 連接失敗等連鎖問題。本文系統梳理根因與解決路徑。
| 特性 | ISAPI (php5isapi.dll) | CGI (php-cgi.exe) |
|---|---|---|
| 進程模型 | IIS 工作進程內載入 (w3wp.exe) | 獨立進程池 (php-cgi.exe) |
| 環境變量繼承 | ❌ 不繼承系統環境變量 | ✅ 繼承系統環境變量 |
| PHPRC 生效 | ❌ 無效 | ✅ 生效 |
| PATH 讀取 | ❌ 無效 | ✅ 生效 |
| 性能 | 略高(進程內) | 略低(進程間通信) |
| 穩定性 | PHP 崩潰導致 IIS 工作進程回收 | PHP 崩潰隔離,不影響 IIS |
結論:強烈建議使用 CGI/FastCGI 模式(IIS 6 需安裝 FastCGI 擴展),徹底解決環境變量問題,並獲得更好隔離性。
; phpinfo() 關鍵輸出
Configuration File (php.ini) Path => C:\Windows ; ❌ 未讀取到自定義 php.ini
Loaded Configuration File => (none) ; ❌ 無加載文件
; 正確應為
Configuration File (php.ini) Path => C:\PHP
Loaded Configuration File => C:\PHP\php.ini
PHPIniDir、CLI -c、NSAPI php_iniHKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePathC:\Windows) 或編譯時 --with-config-file-path原因 1:編輯的文件非 PHP 實際讀取文件 → phpinfo() 確認 Loaded Configuration File
原因 2:未完全重啟 IIS → net stop iisadmin /y && net start w3svc(單站點重啟無效)
原因 3:ISAPI 模式下 PHPRC 無效 → 遷移至 CGI/FastCGI
extension_dir 指向正確目錄(phpinfo() 驗證)php.ini 取消註釋 extension=php_mysql.dlllibmysql.dll 必須在系統 PATH 中
C:\Windows\System32(簡單但升級麻煩)System32 下存在舊版 libmysql.dll 且被鎖定,重命名後重啟 IISphpinfo() 顯示 mysql 區塊,但連接失敗 → 多半是 libmysql.dll 版本不匹配或路徑衝突。檢查 phpinfo() 中 Client API version 與 MySQL 服務端版本兼容性。
PHPRCC:\PHP(php.ini 所在目錄)Path 末尾追加 ;C:\PHP(含分號分隔)cmd → net stop iisadmin /y → net start w3svcphpinfo() 確認 Loaded Configuration File、extension_dir、mysql 區塊正常1. 下載 PHP 非線程安全版 (Non Thread Safe, NTS) + FastCGI for IIS 6.0
2. 安裝 FastCGI 擴展 (fcgiext.dll),配置 fcgiext.ini:
[Types]
php=PHP
[PHP]
ExePath=C:\PHP\php-cgi.exe
InstanceMaxRequests=10000
EnvironmentVars=PHP_FCGI_MAX_REQUESTS:10000
3. IIS 管理器 → 網站屬性 → 主目錄 → 配置 → 添加映射
.php → C:\WINDOWS\system32\inetsrv\fcgiext.dll → GET,HEAD,POST
4. 移除舊 ISAPI 映射 (php5isapi.dll)
5. 重啟 IIS,驗證 phpinfo() 顯示 Server API: CGI/FastCGI
Windows 2003 + IIS 6 部署 PHP 的核心坑點在於 ISAPI 模式不支持系統環境變量。遷移至 FastCGI 模式,配合標準化的 PHPRC 和 PATH 配置,可徹底解決 php.ini 讀取、擴展庫載入、MySQL 客戶端庫查找等全鏈路問題。雖 Win2003 已停止支援,但存量系統維護仍需掌握此遺留技術棧的調試邏輯。