如何在 XAMPP 中启用和使用 Xdebug 进行 PHP 调试

已编辑 3 几个月前 通过 ExtremeHow 编辑团队

Xdebug调试工具PHPXAMPP开发环境调试开发服务器本地主机配置视窗软件

调试是软件开发过程中必不可少的一部分。它帮助程序员识别和修复代码中的错误。PHP 是一种流行的服务器端脚本语言，许多开发人员使用 XAMPP 作为本地开发环境。Xdebug 是一个提供调试和性能分析功能的 PHP 扩展。本文将指导您完成在 XAMPP 中启用和使用 Xdebug 进行 PHP 调试的过程。

了解 Xdebug

Xdebug 是一个强大的工具，可以帮助 PHP 开发人员不仅进行代码调试，还可以进行性能分析和优化。它与各种 IDE 集成，提供如堆栈跟踪、断点、变量显示等功能。使用 Xdebug，开发人员可以简化调试过程，使其更高效。

安装 XAMPP

在集成 Xdebug 之前，您需要在开发计算机上安装 XAMPP。XAMPP 是一个免费开源的跨平台 web 服务器解决方案堆栈软件包，其中包括 Apache HTTP Server、MariaDB，以及用于 PHP 和 Perl 编程语言的解释器。

1. 从XAMPP 的官方网站下载适用于您操作系统的 XAMPP 安装包。
2. 运行安装程序并按照屏幕提示在您的计算机上安装 XAMPP。
3. 安装完成后，从 XAMPP 控制面板启动 Apache 和 MySQL 服务以确保您的 XAMPP 安装正常工作。

在 XAMPP 中启用 Xdebug

安装并运行 XAMPP 后，下一步就是启用 Xdebug。您需要调整一些配置设置以激活 Xdebug，因为它可能默认未启用。

步骤 1：检查 Xdebug 安装

1. 打开 XAMPP 控制面板并启动 Apache 服务器。
2. 打开您的网络浏览器并访问 http://localhost/dashboard/phpinfo.php。
3. 查找标题为“已加载配置”的部分，或在 phpinfo 页面中搜索“Xdebug”。
4. 如果列出了 Xdebug，则表示它已安装。如果没有，请继续手动下载并安装。

步骤 2：手动安装 Xdebug

如果您的 XAMPP 包中尚未安装 Xdebug，请按照以下步骤手动安装：

1. 通过在 phpinfo 输出中搜索“PHP 版本”来检查您当前的 PHP 版本。它会是类似 7.4.12 或 8.0.3 的版本。
2. 访问Xdebug 下载页面并下载适合您 PHP 版本的 Xdebug 版本。
3. 下载与您的 PHP 版本和系统架构（32 位或 64 位）兼容的 Xdebug 文件。
4. 下载完成后，您通常会在包中找到一个 .dll 文件。将此文件解压缩到一个方便的位置。
5. 将提取的 php_xdebug.dll 文件复制到您的 XAMPP PHP 扩展目录中，通常位于 C:\xampp\php\ext。

步骤 3：配置 PHP 以使用 Xdebug

确认 Xdebug 文件位于正确的目录后，下一步是编辑 PHP 配置文件以注册 Xdebug 并开始使用它。

1. 使用文本编辑器打开位于 C:\xampp\php 目录中的 php.ini 文件。
2. 确认 zend_extension 指令指向下载的 Xdebug DLL 的正确文件名。

; 假设 Xdebug 版本是 php_xdebug-2.9.8-7.4-vc14-x86_64.dll zend_extension="C:\xampp\php\ext\php_xdebug.dll"

3. 找到相关的 Xdebug 配置部分或添加一个新部分以注册 Xdebug：

[Xdebug] xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_port=9003 xdebug.log="C:/xampp/tmp/xdebug.log"

4. 保存对 php.ini 文件的更改并使用 XAMPP 控制面板重新启动 Apache 服务。

使用 Xdebug 进行 PHP 调试

现在启用了 Xdebug，您可以在您最喜欢的 IDE 中使用其调试功能。许多 IDE 如 PhpStorm、Visual Studio Code 和 Eclipse 支持 Xdebug 集成。

配置 IDE 以使用 Xdebug 进行调试

我们以 Visual Studio Code 为例：

1. 确保您的计算机上安装了 Visual Studio Code。
2. 打开 Visual Studio Code 并从市场安装 PHP Debug 扩展。
3. 通过单击侧边栏菜单中的播放按钮与虫子图标切换到“运行和调试”视图。
4. 单击“创建 launch.json 文件”，然后选择“PHP”以创建调试配置。
5. 它会自动生成一个 launch.json 文件，您可以在其中调整诸如端口之类的设置，该端口应与 php.ini 中的 xdebug.client_port 匹配。

设置断点和调试

1. 在 Visual Studio Code 中打开要调试的 PHP 文件。
2. 通过单击行号左侧的边距或使用 F9 切换断点来设置断点。
3. 通过单击“运行和调试”视图中的绿色播放按钮开始 PHP 调试会话。
4. 启动浏览器并触发您正在处理的 PHP 脚本。执行应在您的断点处停止，允许您在 Visual Studio Code 的调试器面板中检查变量、堆栈跟踪等。

了解 Xdebug 的功能和优势

除了基本调试，Xdebug 还提供许多先进的功能，可以极大地改进 PHP 调试：

• 堆栈跟踪：当 PHP 错误发生时，Xdebug 可以提供详细的堆栈跟踪，显示导致错误的函数调用和执行路径。
• 变量输出：Xdebug 允许您检查所有当前定义变量的值，使了解代码的执行变得更容易。
• 性能分析：Xdebug 可以生成 Cachegrind 格式的性能分析数据，这对您的 PHP 脚本的性能分析非常有用。
• 代码覆盖率：Xdebug 可以分析哪些代码行被执行，这对于单元测试和确定代码测试覆盖率很有帮助。

结论

在 XAMPP 中启用 Xdebug 并将其与 IDE 集成进行 PHP 调试显着增强了软件开发过程。具有堆栈跟踪、变量检查和性能分析等功能，Xdebug 是 PHP 开发人员不可或缺的工具。本教程提供了有关如何安装和启用 Xdebug、在 XAMPP 中进行配置的全面概述，并在您的开发环境中高效使用它来提高 PHP 应用程序中的调试能力。

通过继续探索和实验 Xdebug 的功能，开发人员可以进一步优化调试方法，从而编写出高质量、更健壮的 PHP 代码。调试不再是令人生畏的任务；使用合适的工具和技术，它可以流畅、高效，并成为每个开发项目中不可或缺的一部分。

  分享本文

如果你发现文章内容有误, 您可以 请求更新