PHP 7.1 + Xdebug 调试环境搭建完整指南（Windows 11）

一、下载 PHP 7.1

1. 访问 PHP 官方下载页面：windows.php.net/download
2. 找到 "Old Versions" 区域，点击进入 PHP 7.1 系列
3. 选择最新版本 php-7.1.33-Win32-VC14-x64.zip（64位系统）下载

二、安装 PHP

1. 将下载的压缩包解压到目标目录，例如：D:\Development\php_compiler\php-7.1.33-Win32-VC14-x64
2. 进入该目录，复制 php.ini-development 文件并重命名为 php.ini
3. 用记事本打开 php.ini，找到 ;extension_dir = "ext" 这一行，去掉行首的分号，确保变为：

   extension_dir = "ext"
   

4. 将 PHP 目录添加到系统环境变量 Path 中：
   • 右键"此电脑" → 属性 → 高级系统设置 → 环境变量
   • 在系统变量中找到 Path，编辑添加：D:\Development\php_compiler\php-7.1.33-Win32-VC14-x64
5. 打开新的命令行窗口，验证安装：

   php -v
   

   看到 PHP 版本信息即表示成功

三、安装 Xdebug

1. 在命令行运行 php -v，复制完整输出
2. 访问 Xdebug 安装向导：xdebug.org/wizard
3. 将复制的输出粘贴到文本框，点击"分析"
4. 根据向导提示：
   • 下载推荐的 php_xdebug-2.9.8-7.1-vc14-x86_64.dll
   • 将文件移动到 PHP 目录下的 ext 文件夹
   • 重命名为 php_xdebug.dll
5. 编辑 php.ini，在文件末尾添加：

   zend_extension = D:\Development\php_compiler\php-7.1.33-Win32-VC14-x64\ext\php_xdebug.dll
   

   （注意：使用绝对路径可以避免加载失败的问题）
6. 再次运行 php -v，看到以下输出即表示 Xdebug 安装成功：

   PHP 7.1.33 (cli) ... with Xdebug v2.9.8 ...
   

四、PhpStorm 配置

1. 打开 PhpStorm，进入 File → Settings（或 Ctrl+Alt+S）
2. 导航到 PHP，点击 CLI Interpreter 右侧的 ... 按钮
3. 点击 + 号，选择 Local Path to Web Server
4. 将 PHP 可执行文件路径指向你的 php.exe，例如：D:\Development\php_compiler\php-7.1.33-Win32-VC14-x64\php.exe

五、常见问题解决

问题1：Xdebug 加载失败，提示 "Failed loading ext\ext\php_xdebug.dll"

原因：路径配置错误 解决：在 php.ini 中使用绝对路径：

zend_extension = D:\Development\php_compiler\php-7.1.33-Win32-VC14-x64\ext\php_xdebug.dll

环境信息：

• 操作系统：Windows 11
• PHP 版本：7.1.33
• Xdebug 版本：2.9.8
• IDE：PhpStorm

按照以上步骤，你应该能成功搭建 PHP 7.1 + Xdebug 的调试环境。如果在配置过程中遇到其他问题，欢迎留言交流！