萬盛學電腦網

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

IIS + PHP 環境建置完全指南:FastCGI 與 PHP Manager 兩大方案詳解

在 Windows Server 上以 IIS 裝載 PHP,早期常見 ISAPI 方案 (php5isapi.dll) 在 PHP 5.3+ 已移除支援。現代標準做法是使用 FastCGI,搭配 PHP Manager for IIS 圖形化管理工具,能大幅簡化部署與多版本共存。本文記錄完整建置流程、常見坑點與驗證步驟。

架構演進:為什麼不再用 ISAPI?

  • PHP 5.3+ 移除 php5isapi.dll,僅保留 php-cgi.exe (FastCGI 進程)。
  • ISAPI 在 IIS 執行緒模型下穩定性差,記憶體洩漏會導致整個 Worker Process 回收。
  • FastCGI 獨立進程池,PHP 崩潰不影響 IIS,支援進程回收、記憶體限制、多版本並行。

方案一:Web Platform Installer (Web PI) - 官方自動化安裝 (舊版)

注意:Microsoft 已於 2022 年停止維護 Web PI,新專案建議改用方案二。

  1. 下載 Web PI:https://www.iis.net/downloads/microsoft/web-platform-installer
  2. 執行安裝,搜尋 "PHP" → 選擇所需版本 (如 PHP 7.4, 8.1, 8.2) → 安裝。
  3. Web PI 會自動:安裝 PHP、設定 FastCGI 模組、註冊處理常式、調整 php.ini。
  4. 驗證:瀏覽 https://localhost/phpinfo.php。

方案二:手動安裝 + PHP Manager for IIS (推薦、現代標準)

步驟 1:啟用 IIS CGI 功能

# PowerShell 管理員執行
Enable-WindowsOptionalFeature -Online -FeatureName IIS-CGI
# 或 GUI:控制台 → 程式集 → 開啟/關閉 Windows 功能 → IIS → 万维网服务 → 应用程序开发 → CGI

步驟 2:下載並安裝 PHP (Non Thread Safe 版本)

  • 官網:https://windows.php.net/download/
  • 選擇 Non Thread Safe (NTS) x64 版本 (IIS FastCGI 必須用 NTS)。
  • 解壓縮至 C:\php\php-8.2-nts (建議版本化目錄,方便多版本共存)。
  • 複製 php.ini-development 為 php.ini 並調整關鍵設定:
    ; php.ini 關鍵設定
    extension_dir = "ext"
    date.timezone = "Asia/Taipei"
    cgi.force_redirect = 0
    cgi.fix_pathinfo = 1
    fastcgi.impersonate = 1
    fastcgi.logging = 0
    ; 啟用常用擴展
    extension=curl
    extension=gd
    extension=mbstring
    extension=mysqli
    extension=pdo_mysql
    extension=openssl
    extension=zip
    

步驟 3:安裝 PHP Manager for IIS

  • GitHub Releases:https://github.com/phpmanager/phpmanager/releases (原 CodePlex 已關閉)
  • 下載 PHPManagerForIIS-1.2.0.msi (或最新版) 安裝。
  • 安裝後 IIS 管理員會出現「PHP Manager」圖示。

步驟 4:註冊 PHP 版本

  1. 開啟 IIS 管理員 → 伺服器節點 → 點擊「PHP Manager」。
  2. 點擊右側「Register new PHP version」。
  3. 瀏覽選擇 C:\php\php-8.2-nts\php-cgi.exe。
  4. PHP Manager 自動:建立 FastCGI 應用程式池、註冊 *.php 處理常式、產生 php.ini 備份。
  5. 可重複此步驟註冊多個 PHP 版本 (如 7.4, 8.1, 8.2 共存)。

步驟 5:為網站指定 PHP 版本

  1. IIS 管理員 → 選擇目標網站 → 點擊「PHP Manager」。
  2. 點擊「Change PHP version」→ 選擇該網站使用的版本。
  3. 或在網站根目錄放置 .user.ini 指定 php_version=8.2 (需 PHP Manager 1.2+)。

步驟 6:驗證安裝

<?php
// phpinfo.php 放於網站根目錄
phpinfo();

瀏覽 https://your-site/phpinfo.php,確認:

  • Server API: CGI/FastCGI
  • PHP Version: 符合預期版本
  • Loaded Configuration File: 指向正確 php.ini
  • 擴展模組正確載入 (curl, gd, mbstring, pdo_mysql...)

進階設定與優化

FastCGI 進程池調整 (applicationHost.config)


  
    
      
        
        
      
    
  

  • maxInstances:最大同時 PHP-CGI 進程數 (依 CPU 核心與記憶體調整)。
  • instanceMaxRequests:單一進程處理請求數上限 (防記憶體洩漏自動回收)。
  • activityTimeout:閒置進程存活秒數。

啟用 WinCache / OPcache 加速

; php.ini
zend_extension=opcache
opcache.enable=1
opcache.memory_consumption=256
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=20000
opcache.revalidate_freq=60
opcache.fast_shutdown=1
opcache.enable_cli=1

; Windows 專用 WinCache (需額外安裝)
extension=wincache
wincache.ocenabled=1
wincache.fcenabled=1

錯誤日誌與權限設定

; php.ini
error_log = "C:\php\logs\php_errors.log"
log_errors = On
display_errors = Off
upload_tmp_dir = "C:\php\uploadtmp"
session.save_path = "C:\php\session"
; 確保 IIS_IUSRS 對上述目錄有讀寫權限

常見問題排查

HTTP 500.0 - Internal Server Error (FastCGI Error)
檢查 C:\php\logs\php_errors.log;常見原因:php.ini 語法錯誤、擴展 DLL 缺失 (如缺 vcruntime140.dll 需安裝 VC++ Redistributable)、權限不足。
HTTP 404.3 - Not Found (Handler mapping missing)
PHP Manager 未正確註冊處理常式。檢查「處理常式對應」是否有 *.php → FastCgiModule → php-cgi.exe。
No input file specified
cgi.fix_pathinfo=1 未開啟、或網站實體路徑與 URL 路徑不符。
權限錯誤 (500.19 / 401.3)
網站實體路徑權限:IIS_IUSRS (應用程式池身分) 需有讀取/執行權限;上傳/快取目錄需寫入權限。
多版本 PHP 衝突
每個網站在 PHP Manager 獨立指定版本;全域預設版本不影響個別網站設定。

遷移自 Apache 的注意事項

ApacheIIS 等效設定
.htaccess RewriteRuleweb.config <rewrite> 規則
php_value/php_flag.user.ini (目錄級) 或 PHP Manager 設定
SetEnvweb.config <environmentVariables> 或 FastCGI 環境變數
DirectoryIndexIIS「預設文件」功能

生產環境部署清單

  • [ ] PHP NTS 版本 + VC++ Redistributable 安裝
  • [ ] php.ini 生產模式調整 (display_errors=Off, opcache.enable=On)
  • [ ] PHP Manager 註冊版本 + 指定網站版本
  • [ ] FastCGI 進程池參數調優
  • [ ] 錯誤日誌目錄權限、上傳目錄權限、Session 目錄權限
  • [ ] TLS/SSL 憑證綁定、HSTS、安全標頭
  • [ ] 健康檢查端點 (/healthz) 供負載平衡器探測
  • [ ] 備份/還原腳本 (含 php.ini、web.config、憑證)

IIS + PHP 早已不是「次選方案」,配合 FastCGI 與 PHP Manager,在 Windows 生態系擁有優異效能、原生整合 (AD 認證、憑證存儲)、圖形化管理優勢。掌握標準建置流程,讓 PHP 在 Windows 也能穩定高效運行!

copyright © 萬盛學電腦網 all rights reserved