ServBay

简体中文

English
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

简体中文

English
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

Appearance

如何启用ServBay自带的Xdebug模块 ​

作为强大的集成式Web开发工具，ServBay自带了Xdebug模块，并且其启用过程非常简便。Xdebug是一个PHP的调试和分析工具，能够帮助开发者进行代码调试、性能分析和代码覆盖率检测，是开发和维护PHP应用的利器。

Xdebug模块简介 ​

Xdebug是一个功能强大的PHP扩展，用于调试和分析PHP代码。它提供了丰富的调试功能，包括断点调试、堆栈跟踪、变量监视等。此外，Xdebug还支持性能分析和代码覆盖率检测，帮助开发者优化代码性能和保证代码质量。

主要特点 ​

  1. 断点调试：Xdebug支持在代码中设置断点，逐行调试代码，方便查找和修复错误。
  2. 堆栈跟踪：在发生错误时，Xdebug可以生成详细的堆栈跟踪信息，帮助开发者快速定位问题。
  3. 性能分析：Xdebug提供了性能分析功能，可以生成详细的性能报告，帮助开发者优化代码性能。
  4. 代码覆盖率：Xdebug支持代码覆盖率检测，帮助开发者确保测试覆盖了所有代码路径。
  5. 集成开发环境支持：Xdebug可以与多种集成开发环境（IDE）集成，如PHPStorm、Visual Studio Code等，提供方便的调试体验。

ServBay自带的Xdebug模块版本 ​

ServBay支持多个PHP版本，并且为每个版本预装了相应的Xdebug模块。具体版本如下：

  • PHP 5.6、7.0、7.1：Xdebug 2.5.5
  • PHP 7.2、7.3、7.4：Xdebug 3.1.6
  • PHP 8.0、8.1、8.2、8.3：Xdebug 3.3.1
  • PHP 8.4：Xdebug 3.4.0-dev

提示

每个版本的PHP Xdebug端口互相独立，与版本号相关联，比如PHP 7.2的Xdebug端口是39072，PHP 8.3的Xdebug端口是39083

如何启用Xdebug模块 ​

默认情况下，Xdebug模块是禁用的。启用Xdebug模块的步骤非常简单，只需导航到语言-PHP，选择要启用模块的 PHP 版本，比如 PHP 8.4，点击右侧的扩展，然后在Xdebug模块的左侧打开开关，保存即可。

用户也可以手动打开或者修改模块配置，以下是详细步骤：

步骤一：找到配置文件 ​

首先，定位到对应PHP版本的conf.d目录。例如，要为PHP 8.3启用Xdebug模块，我们需要编辑以下文件：

/Applications/ServBay/etc/php/8.3/conf.d/xdebug.ini

步骤二：编辑配置文件 ​

打开xdebug.ini文件，取消注释以下内容：

ini
[Xdebug]
; Uncomment the following line to enable XDebug
zend_extension = xdebug.so

步骤三：配置Xdebug参数 ​

为了充分利用Xdebug的功能，可以在xdebug.ini中配置一些常用参数。例如：

ini
xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.client_host=localhost
xdebug.client_port=39083
xdebug.log=/Applications/ServBay/logs/xdebug/8.3/xdebug.log

步骤四：重启PHP服务 ​

在ServBay的服务管理面板中，重启相应的PHP服务。例如，重启PHP 8.3的服务。重启完成后，Xdebug模块将成功加载。

验证Xdebug模块是否成功加载 ​

可以通过创建一个简单的PHP文件来验证Xdebug模块是否成功加载。在Web服务器的根目录下创建一个phpinfo.php文件，内容如下：

php
<?php
phpinfo();
?>

访问https://servbay.host/phpinfo.php，在输出的PHP信息页面中查找Xdebug模块的相关信息。如果看到Xdebug的相关信息，说明模块已经成功加载。

如何启用ServBay自带的Xdebug模块

在PHPStorm中配置Xdebug ​

为了在PHPStorm中使用Xdebug进行调试，需要进行以下配置步骤：

步骤一：打开PHPStorm并进入设置 ​

  1. 打开PHPStorm。
  2. 点击菜单栏中的 File，然后选择 Settings（Windows/Linux）或 Preferences（macOS）。

步骤二：配置PHP解释器 ​

  1. 在设置窗口中，导航到 Languages & Frameworks -> PHP。
  2. 在 CLI Interpreter 部分，点击右侧的 ... 按钮。
  3. 在弹出的窗口中，点击 + 号添加新的PHP解释器，选择 Local。
  4. 设置PHP解释器路径为ServBay中对应的PHP版本的路径，例如 /Applications/ServBay/package/php/8.3/8.3.7/bin/php。
  5. 点击 OK 保存设置。 如何启用ServBay自带的Xdebug模块

步骤三：配置Xdebug调试 ​

提示

每个版本的PHP Xdebug端口互相独立，与版本号相关联，比如PHP 7.2的Xdebug端口是39072，PHP 8.3的Xdebug端口是39083

  1. 在设置窗口中，导航到 Languages & Frameworks -> PHP -> Debug。
  2. 在 Xdebug 部分，设置 Debug Port 为 39083，与 xdebug.client_port 配置一致。
  3. 确保 Can accept external connections 选项已勾选。
  4. 点击 Apply 然后点击 OK 保存设置。 如何启用ServBay自带的Xdebug模块

步骤四：配置PHP Web应用服务器 ​

  1. 在设置窗口中，导航到 Languages & Frameworks -> PHP -> Servers。
  2. 点击右侧的 + 号添加一个新的服务器配置。
  3. 设置服务器名称，例如 ServBay Localhost。
  4. 设置 Host 为你在ServBay主机中对应的host，比如 servbay.new，端口为443（HTTPS）。
  5. 设置 Debugger 为 Xdebug。
  6. 点击 OK 保存设置。 如何启用ServBay自带的Xdebug模块如何启用ServBay自带的Xdebug模块

步骤五：启动调试会话 ​

  1. 在PHPStorm中打开你想要调试的PHP项目。
  2. 在代码中设置断点（点击行号左侧的空白区域）。
  3. 点击PHPStorm顶部工具栏中的 Start Listening for PHP Debug Connections 按钮（小虫子图标）。
  4. 在浏览器中访问你的PHP应用，Xdebug会自动连接到PHPStorm并在断点处暂停执行。 如何启用ServBay自带的Xdebug模块

结论 ​

ServBay提供了便捷的方式来管理和启用Xdebug模块。通过简单的配置和重启操作，开发者可以快速地在不同PHP版本中启用Xdebug模块，从而充分利用其强大的调试和分析功能，提升PHP应用的开发和维护效率。Xdebug的断点调试、性能分析和代码覆盖率检测功能使得它成为PHP开发者不可或缺的工具。