温馨提示×

phpstorm在Ubuntu上如何远程调试

小樊
41
2025-06-07 13:39:06
栏目: 编程语言

在Ubuntu上使用PhpStorm进行远程PHP调试,可以按照以下步骤进行配置和操作:

安装必要的软件和扩展

  1. 安装PHP和Xdebug
sudo apt-get update
sudo apt-get install php php-xdebug
  1. 配置php.ini
  • 编辑 /etc/php/7.x/apache2/php.ini 文件(其中7.x是你的PHP版本),添加或修改以下配置:
zend_extension /usr/lib/php/20090626/xdebug.so
xdebug.mode = debug
xdebug.client_host = 127.0.0.1
xdebug.client_port = 9003
xdebug.remote_enable = 1
xdebug.remote_handler = dbgp
xdebug.remote_autostart = 1
xdebug.idekey = PHPSTORM

请根据你的PHP版本和Web服务器进行相应的调整。

  1. 重启Web服务器
sudo service apache2 restart

配置PhpStorm

  1. 打开PhpStorm,然后依次点击 File > Settings(或使用快捷键 Ctrl+Alt+S)。

  2. 配置远程调试

  • 在设置窗口中,导航到 Languages & Frameworks > PHP > Debug
  • 点击右上角的齿轮图标,选择 Add
  • 在弹出的对话框中,选择 Remote 作为解释器类型。
  • Host 字段中输入远程服务器的IP地址或域名(例如 127.0.0.1),在 Port 字段中输入 9003(与php.ini中的配置一致)。
  • 点击 Test Connection 以确保连接成功,然后点击 OK 以添加远程解释器。
  1. 配置Run/Debug配置
  • 返回PhpStorm的主界面,转到 Run > Edit Configurations
  • 点击左上角的加号图标,选择 PHP Built-in Web Server
  • Document root 字段中输入远程服务器上的项目目录(例如 /var/www/html/my_project)。
  • Port 字段中输入一个可用的端口号(例如 8000),以便从本地计算机访问远程服务器上的PhpStorm项目。
  • 点击 OK 以保存配置。

启动调试会话

  1. 在PhpStorm的右上角,点击绿色的电话图标(或使用快捷键 Shift+F5)启动调试会话。

  2. 确保你的Web服务器正在运行。

  3. 在浏览器中访问你的PHP应用程序,触发设置了断点的代码。当代码执行到断点时,PhpStorm将自动切换到调试视图,你可以查看变量值、调用堆栈等信息。

注意事项

  • 确保你的防火墙允许从本地机器到远程服务器的9003端口的连接。
  • 如果你使用的是Docker容器,确保Xdebug配置正确,并且容器内的PHP能够访问到主机的9003端口。

通过以上步骤,你就可以在Ubuntu上使用PhpStorm进行远程调试PHP代码了。如果遇到问题,请检查Xdebug扩展是否正确安装,以及PhpStorm和Xdebug的配置是否正确。

0