Debian上phpstorm如何远程调试

Debian上PhpStorm远程调试配置指南

1. 安装Xdebug扩展

在Debian服务器上，通过APT包管理器安装Xdebug（确保PHP版本与Xdebug兼容）：

sudo apt-get update
sudo apt-get install php-xdebug

安装完成后，Xdebug会自动集成到PHP环境中，但需进一步配置才能启用远程调试。

2. 配置php.ini文件

编辑PHP的全局配置文件（路径可通过php --ini命令查看，常见为/etc/php/8.2/cli/php.ini或/etc/php/8.2/apache2/php.ini），在文件末尾添加以下配置：

[xdebug]
zend_extension=/usr/lib/php/20220829/xdebug.so  # 根据实际Xdebug路径调整（通过`php -i | grep extension_dir`查看）
xdebug.mode=debug
xdebug.client_host=127.0.0.1  # 若PhpStorm与服务器在同一机器，用127.0.0.1；否则填PhpStorm所在机器的IP
xdebug.client_port=9003       # 默认端口，可与PhpStorm设置保持一致
xdebug.start_with_request=yes # 自动触发调试（可选：trigger/yes，trigger需通过浏览器扩展或GET参数启动）
xdebug.idekey=PHPSTORM        # IDE标识，需与PhpStorm配置一致

保存后重启Web服务器（Apache/Nginx）使配置生效：

sudo systemctl restart apache2  # Apache
# 或
sudo systemctl restart nginx    # Nginx

3. 配置PhpStorm远程解释器

1. 打开PhpStorm，进入File > Settings > PHP（或PhpStorm > Preferences > PHP）。
2. 点击右上角齿轮图标→Add，选择SSH Interpreter。
3. 输入Debian服务器的IP地址、SSH端口（默认22）、用户名，选择认证方式（密码或密钥）。
4. PHPStorm会自动检测服务器上的PHP解释器路径（如/usr/bin/php），确认后点击Finish。

4. 配置PHP Servers

1. 进入File > Settings > PHP > Servers，点击+添加新服务器。
2. 输入服务器名称（如Debian-Remote），设置Host为服务器IP或域名，Port为Web服务端口（如80/443）。
3. 勾选Use path mappings，将本地项目目录与远程服务器目录映射（例如：本地/home/user/project→远程/var/www/html/project）。

5. 配置调试监听

1. 进入Run > Edit Configurations，点击+添加PHP Remote Debug配置。
2. 选择之前创建的Debian-Remote服务器，确认Port与php.ini中的xdebug.client_port一致（如9003）。
3. 点击OK保存配置。

6. 启动调试会话

1. 在PhpStorm中打开项目，点击顶部工具栏的电话图标（或按Shift+F9）开始监听调试连接。
2. 在代码中设置断点（点击行号左侧）。
3. 触发调试：
   • 方式一：通过浏览器访问项目URL（如http://your-server-ip/project），Xdebug会自动连接PhpStorm。
   • 方式二：安装浏览器扩展（如Xdebug Helper），点击扩展图标并选择Debug模式，再访问页面。
4. 当代码执行到断点时，PhpStorm会暂停并显示调试面板（可查看变量、调用栈等信息）。

常见问题排查

• 端口冲突：若xdebug.client_port端口被占用，修改为其他端口（如9007），并同步更新php.ini和PhpStorm配置。
• 防火墙问题：确保服务器防火墙允许xdebug.client_port端口的入站连接（如sudo ufw allow 9003/tcp）。
• 路径映射错误：检查Servers配置中的本地与远程目录映射是否正确，否则无法准确定位代码。
• Xdebug未加载：通过php -m | grep xdebug命令确认Xdebug扩展已加载，未加载则重启PHP-FPM或Web服务器。

通过以上步骤，即可在Debian服务器上使用PhpStorm进行远程调试，实现本地与远程代码的无缝调试体验。