在 Windows Server 上以 IIS 裝載 PHP,早期常見 ISAPI 方案 (php5isapi.dll) 在 PHP 5.3+ 已移除支援。現代標準做法是使用 FastCGI,搭配 PHP Manager for IIS 圖形化管理工具,能大幅簡化部署與多版本共存。本文記錄完整建置流程、常見坑點與驗證步驟。
php5isapi.dll,僅保留 php-cgi.exe (FastCGI 進程)。注意:Microsoft 已於 2022 年停止維護 Web PI,新專案建議改用方案二。
https://www.iis.net/downloads/microsoft/web-platform-installerphp.ini。https://localhost/phpinfo.php。# PowerShell 管理員執行
Enable-WindowsOptionalFeature -Online -FeatureName IIS-CGI
# 或 GUI:控制台 → 程式集 → 開啟/關閉 Windows 功能 → IIS → 万维网服务 → 应用程序开发 → CGI
https://windows.php.net/download/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
https://github.com/phpmanager/phpmanager/releases (原 CodePlex 已關閉)PHPManagerForIIS-1.2.0.msi (或最新版) 安裝。C:\php\php-8.2-nts\php-cgi.exe。*.php 處理常式、產生 php.ini 備份。.user.ini 指定 php_version=8.2 (需 PHP Manager 1.2+)。<?php
// phpinfo.php 放於網站根目錄
phpinfo();
瀏覽 https://your-site/phpinfo.php,確認:
CGI/FastCGIphp.ini
maxInstances:最大同時 PHP-CGI 進程數 (依 CPU 核心與記憶體調整)。instanceMaxRequests:單一進程處理請求數上限 (防記憶體洩漏自動回收)。activityTimeout:閒置進程存活秒數。; 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 對上述目錄有讀寫權限
C:\php\logs\php_errors.log;常見原因:php.ini 語法錯誤、擴展 DLL 缺失 (如缺 vcruntime140.dll 需安裝 VC++ Redistributable)、權限不足。*.php → FastCgiModule → php-cgi.exe。cgi.fix_pathinfo=1 未開啟、或網站實體路徑與 URL 路徑不符。IIS_IUSRS (應用程式池身分) 需有讀取/執行權限;上傳/快取目錄需寫入權限。| Apache | IIS 等效設定 |
|---|---|
| .htaccess RewriteRule | web.config <rewrite> 規則 |
| php_value/php_flag | .user.ini (目錄級) 或 PHP Manager 設定 |
| SetEnv | web.config <environmentVariables> 或 FastCGI 環境變數 |
| DirectoryIndex | IIS「預設文件」功能 |
IIS + PHP 早已不是「次選方案」,配合 FastCGI 與 PHP Manager,在 Windows 生態系擁有優異效能、原生整合 (AD 認證、憑證存儲)、圖形化管理優勢。掌握標準建置流程,讓 PHP 在 Windows 也能穩定高效運行!