PHPStorm如何在Ubuntu上配置Xdebug

2025年8月5日 互联网

在Ubuntu上为PHPStorm配置Xdebug的步骤如下：

安装Xdebug扩展

  1. 打开终端。
  2. 更新包列表：
sudo apt-get update
  1. 安装PHP Xdebug扩展：
sudo apt-get install php-xdebug

如果您使用的是PHP 7.2或更高版本，请安装 php7.x-xdebug，其中 x 是您的PHP版本号。

配置Xdebug

  1. 找到您的 php.ini 文件。它的位置可能因系统而异，但通常可以在以下路径找到：

    • /etc/php/{version}/cli/php.ini
    • /etc/php/{version}/apache2/php.ini
      将其中的 {version} 替换为您的PHP版本。如果您不确定使用的是哪个版本，请运行 php -v 命令查看。

  2. 使用文本编辑器打开 php.ini 文件，例如：

sudo nano /etc/php/7.x/cli/php.ini
  1. 在文件末尾添加以下配置：
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.start_with_request=yes
xdebug.idekey=PHPSTORM

请确保 xdebug.idekey 的值与PHPStorm中的设置相匹配。

  1. 保存并关闭文件。

重启Web服务器

如果您使用的是Apache，请运行以下命令重启Apache：

sudo systemctl restart apache2

如果您使用的是Nginx和PHP-FPM，请运行以下命令重启PHP-FPM和Nginx：

sudo systemctl restart php7.x-fpm
sudo systemctl restart nginx

将 7.x 替换为您的PHP版本号。

配置PhpStorm

  1. 打开PhpStorm。

  2. 转到 File > Settings（或 PhpStorm > Preferences，如果您使用的是macOS）。

  3. 在设置窗口中，导航到 Languages & Frameworks > PHP > Servers。

  4. 点击 + 按钮添加一个新的服务器，输入服务器名称、主机名（通常是 localhost）和端口号（例如 80 或 443），然后点击 OK。

  5. 接下来，转到 Languages & Frameworks > PHP > Debug。确保Xdebug选项已启用，并且端口与之前在 php.ini 文件中设置的端口相匹配（默认为 9003）。

  6. 点击 OK 保存设置。

设置断点

  1. 在您的PHP代码中，点击行号旁边的空白区域以设置断点。断点将显示为红色圆圈。

启动调试会话

  1. 在PhpStorm的工具栏中，点击绿色的电话图标（或使用快捷键 Shift+F9）启动调试会话。确保您的Web服务器正在运行，并且请求是通过浏览器或其他HTTP客户端发出的。

  2. 调试代码：当代码执行到断点时，PhpStorm将自动暂停执行并显示调试信息。您可以查看变量值、调用堆栈以及在调试器中逐步执行代码。

  3. 结束调试会话：当您完成调试时，点击调试工具栏中的红色方块（或使用快捷键 Ctrl+F2）结束调试会话。

通过以上步骤，您应该可以在Ubuntu上使用PhpStorm进行PHP调试。如果遇到问题，请检查Xdebug扩展是否正确安装，以及PhpStorm和Xdebug的配置是否正确。

最新文章