萬盛學電腦網

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

Windows 8.1 + IIS + PHP 5.6 開發環境完整搭建指南(含 Xdebug 斷點調試)

前言

許多 PHP 開發者傾向 Linux 環境,但 Windows 配合 IIS 同樣能構建高效開發環境。本文記錄 Win 8.1 下 IIS + PHP 5.6 + Xdebug + PhpStorm 完整搭建流程,重點解決斷點調試配置痛點,助新手避開坑點。

系統環境準備

1. 啟用 .NET Framework 3.5(IIS 依賴)

離線安裝最快:掛載 Win 8.1 ISO 到虛擬光碟(假設為 V:),以管理員身分執行 CMD:

dism.exe /online /enable-feature /featurename:NetFX3 /Source:V:\sources\sxs

2. 開啟 IIS 功能

控制台 → 程式集 → 開啟或關閉 Windows 功能 → 勾選「Internet Information Services」→ 確保包含:

  • Web 管理工具 → IIS 管理主控台
  • 全球資訊網服務 → 應用程式開發 → CGI(PHP 必須)
  • 常見 HTTP 功能 → 靜態內容、預設文件、目錄瀏覽、HTTP 錯誤

PHP 5.6 安裝與配置

1. 下載與安裝

  • 官網下載 VC11 x64 Non Thread Safe 版(對應 IIS FastCGI)
  • 解壓至 D:\php\php-5.6.8-nts-Win32-VC11-x64
  • 複製 php.ini-development 為 php.ini

2. 核心 php.ini 設定

; 基礎設定
extension_dir = "ext"
date.timezone = "Asia/Taipei"
cgi.force_redirect = 0
cgi.fix_pathinfo = 1
fastcgi.impersonate = 1

; 常用擴展
extension=php_mbstring.dll
extension=php_mysql.dll
extension=php_mysqli.dll
extension=php_pdo_mysql.dll
extension=php_gd2.dll
extension=php_curl.dll
extension=php_openssl.dll

3. 安裝 PHP Manager for IIS

下載 PHP Manager,安裝後在 IIS 管理員中出現「PHP Manager」圖示,可視化管理 PHP 版本、擴展、錯誤報告等。

Xdebug 斷點調試配置(核心重點)

1. 下載對應版本

  • PHP 5.6 VC11 x64 NTS → php_xdebug-2.3.2-5.6-vc11-nts-x86_64.dll
  • 放入 D:\php\php-5.6.8-nts-Win32-VC11-x64\ext\

2. php.ini 加入 Xdebug 設定

[Xdebug]
zend_extension="D:/php/php-5.6.8-nts-Win32-VC11-x64/ext/php_xdebug-2.3.2-5.6-vc11-nts-x86_64.dll"
xdebug.idekey="PHPSTORM"
xdebug.remote_enable=1
xdebug.remote_host=localhost
xdebug.remote_port=9001
xdebug.remote_autostart=0
xdebug.remote_handler=dbgp
xdebug.profiler_enable=1
xdebug.profiler_output_dir="D:/php/xdebug-log"
xdebug.trace_output_dir="D:/php/xdebug-log"
xdebug.auto_trace=1
xdebug.show_exception_trace=1
xdebug.collect_vars=1
xdebug.collect_return=1
xdebug.collect_params=1
xdebug.max_nesting_level=10000

3. PhpStorm 設定

  1. Settings → Languages & Frameworks → PHP:設定 CLI Interpreter 指向 php.exe
  2. Settings → Languages & Frameworks → PHP → Debug:Debug port 設為 9001(與 xdebug.remote_port 一致)
  3. Settings → Languages & Frameworks → PHP → Servers:新增 Server,Host: localhost,Port: 80,勾選「Use path mappings」,專案路徑對應 WWW 根目錄

4. 瀏覽器擴充套件:Xdebug Helper

  • Chrome 安裝 Xdebug Helper
  • Options → IDE Key 選擇 PhpStorm
  • 工具列圖示點擊選「Debug」模式(蟲子變綠)

驗證調試是否生效

  1. PhpStorm 點擊工具列「Start Listening for PHP Debug Connections」(電話筒圖示變綠)
  2. 程式碼打斷點(行號左側點擊)
  3. 瀏覽器訪問 https://localhost/your-project/index.php
  4. PhpStorm 彈出「Incoming Connection」→ Accept → 進入調試介面

常見問題排查

現象可能原因解決方案
斷點不生效Port 不一致檢查 php.ini xdebug.remote_port = PhpStorm Debug port
Incoming Connection 不彈出Path Mapping 錯誤Servers 設定正確的專案路徑對應
Firefox 無法觸發Xdebug Helper 僅支援 ChromeFirefox 使用 The easiest Xdebug 擴充套件
xdebug.log 無輸出目錄權限或路徑錯誤確認 xdebug.log 目錄存在且 IIS_IUSRS 有寫入權限

總結

Windows + IIS + PHP 開發環境完全可行,關鍵在於:

  1. 選對 PHP 版本(VC11 NTS x64 for IIS)
  2. PHP Manager 簡化擴展管理
  3. Xdebug 版本嚴格對應 PHP 版本/編譯器/執行緒安全性
  4. PhpStorm Path Mapping 與 Port 設定正確

掌握斷點調試,告別 var_dump/echo 原始除錯時代,開發效率將質變提升。

copyright © 萬盛學電腦網 all rights reserved