萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Windows Server 2003 IIS 整合 PHP 環境變量讀取失效完整排查指南

在 Windows Server 2003 + IIS 6.0 環境下部署 PHP,雖 phpinfo() 正常顯示,但環境變量(如 PHPRC、PATH)無法生效,導致 php.ini 未加載、擴展庫未找到、MySQL 連接失敗等連鎖問題。本文系統梳理根因與解決路徑。

核心衝突:ISAPI vs CGI 模式的環境變量差異

特性ISAPI (php5isapi.dll)CGI (php-cgi.exe)
進程模型IIS 工作進程內載入 (w3wp.exe)獨立進程池 (php-cgi.exe)
環境變量繼承❌ 不繼承系統環境變量✅ 繼承系統環境變量
PHPRC 生效❌ 無效✅ 生效
PATH 讀取❌ 無效✅ 生效
性能略高(進程內)略低(進程間通信)
穩定性PHP 崩潰導致 IIS 工作進程回收PHP 崩潰隔離,不影響 IIS

結論:強烈建議使用 CGI/FastCGI 模式(IIS 6 需安裝 FastCGI 擴展),徹底解決環境變量問題,並獲得更好隔離性。

php.ini 尋找順序與生效驗證

; 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

搜索順序(優先級遞減)

  1. SAPI 模塊指定:Apache PHPIniDir、CLI -c、NSAPI php_ini
  2. 註冊表:HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath
  3. 環境變量 PHPRC(CGI 模式生效)
  4. 當前工作目錄(CLI)
  5. Web 服務器目錄(SAPI)或 PHP 安裝目錄
  6. Windows 目錄 (C:\Windows) 或編譯時 --with-config-file-path

三大類故障與解決方案

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

原因 1:編輯的文件非 PHP 實際讀取文件 → phpinfo() 確認 Loaded Configuration File

原因 2:未完全重啟 IIS → net stop iisadmin /y && net start w3svc(單站點重啟無效)

原因 3:ISAPI 模式下 PHPRC 無效 → 遷移至 CGI/FastCGI

故障二:擴展庫載入失敗(以 php_mysql.dll 為例)

  1. 確認 extension_dir 指向正確目錄(phpinfo() 驗證)
  2. php.ini 取消註釋 extension=php_mysql.dll
  3. 關鍵:libmysql.dll 必須在系統 PATH 中
    • 方案 A:複製到 C:\Windows\System32(簡單但升級麻煩)
    • 方案 B:將 PHP 目錄加入系統 PATH 環境變量(推薦,利於升級)
  4. 若 System32 下存在舊版 libmysql.dll 且被鎖定,重命名後重啟 IIS

故障三:MySQL 擴展顯示載入但實際不可用

phpinfo() 顯示 mysql 區塊,但連接失敗 → 多半是 libmysql.dll 版本不匹配或路徑衝突。檢查 phpinfo() 中 Client API version 與 MySQL 服務端版本兼容性。

環境變量配置標準化流程(CGI 模式)

  1. 設置 PHPRC:我的電腦 → 屬性 → 高級 → 環境變量 → 系統變量 → 新建
    • 變量名:PHPRC
    • 變量值:C:\PHP(php.ini 所在目錄)
  2. 擴展 PATH:系統變量 Path 末尾追加 ;C:\PHP(含分號分隔)
  3. 完全重啟 IIS:cmd → net stop iisadmin /y → net start w3svc
  4. 驗證:phpinfo() 確認 Loaded Configuration File、extension_dir、mysql 區塊正常

遷移建議:從 ISAPI 到 FastCGI

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 已停止支援,但存量系統維護仍需掌握此遺留技術棧的調試邏輯。

copyright © 萬盛學電腦網 all rights reserved