IIS 環境下 PHP 調試環境完整部署指南 (圖文詳解版)

適用場景與版本基線

• 作業系統：Windows XP Professional (內建 IIS 5.1)
• Web 伺服器：IIS 5.1 (ISAPI 模式)
• PHP 版本：PHP 4.x / 5.x Windows 安裝包 (MSI/EXE)
• 架構模式：ISAPI 擴充套件 (php4isapi.dll / php5isapi.dll)

現代提示：新專案請優先考慮 PHP 8.x + IIS 10+ (FastCGI)。本文為維護舊專案、教學演示保留。

階段一：PHP 安裝程式精準配置

1. 歡迎頁：點擊 Next
2. 授權協議：選 I Agree
3. 安裝類型：選 Standard (標準)，點 Next
4. 安裝目錄：建議保留預設 (如 C:\PHP)，避免路徑含空格/中文
5. 郵件設定：
   • SMTP 伺服器：填入可用 SMTP (如 smtp.gmail.com 或公司內部)
   • 寄件者 Email：填入有效信箱
6. 伺服器類型 (關鍵步驟)：
   • 選擇 Microsoft IIS 4 or higher
   • 勿選 CGI、Apache、Other
7. IIS Scriptmap 節點選擇：
   • 全選所有站點 (含 Default Web Site)
   • 點擊 OK 完成對應
8. 完成安裝嚚導式

階段二：驗證 IIS 應用程式對應 (圖文核對)

1. 開啟 控制台 → 管理工具 → Internet 信息服務
2. 右鍵 預設網站 → 內容
3. 切換至 主目錄 標籤
4. 點擊 應用程式設定 → 設定
5. 在 對應 標籤的 應用程式對應清單 中尋找：

若缺少 .php 對應 → 手動新增

1. 點擊 新增
2. 可執行檔：C:\PHP\php5isapi.dll (確認實際路徑)
3. 副檔名：.php
4. 其他保持預設 (所有動詞、腳本引擎、檢查檔案存在)
5. 確定 → 確定 → 確定 關閉所有對話框

階段三：建立測試腳本驗證完整鏈路

1. 在網站根目錄 (預設 C:\Inetpub\wwwroot) 建立 test.php：

<?php
phpinfo();
?>

2. 瀏覽器訪問 https://localhost/test.php
3. 成功指標：顯示紫色 PHP 資訊頁，Server API 顯示 ISAPI，載入模組含預期擴充套件

常見失敗排查表

進階優化建議 (可選)

1. 改用 FastCGI (IIS 7+ 原生支援，IIS 5.1/6.0 霍安裝 FCGI 元件)

• 效能優於 ISAPI，支援 PHP 進程池、平滑重啟、opcache 共享
• 現代 PHP 版本 (7.0+) 僅提供 Non Thread Safe (NTS) 版本，必須用 FastCGI

2. 啟用 WinCache / OPcache

; php.ini
extension=php_wincache.dll
; 或 PHP 5.5+
zend_extension=php_opcache.dll
opcache.enable=1
opcache.memory_consumption=128

3. 設定預設文件優先順序

1. IIS 管理器 → 預設網站 → 內容 → 文件 標籤
2. 新增 index.php 並移至最頂端
3. 可同步加入 index.html, default.php 等

總結

IIS + PHP ISAPI 部署核心在於安裝程式正確選擇伺服器類型與Scriptmap 完整對應。按圖文步驟操作，驗證 phpinfo() Server API 為 ISAPI，即完成基礎調試環境。維護舊專案時，此流程仍具參考價值；新專務請直接採用 PHP NTS + FastCGI 現代架構。