Debian上phpstorm远程调试方法

以下是在Debian上使用PhpStorm进行远程调试的步骤：

1. 安装Xdebug扩展
   在远程Debian服务器上执行：

   sudo apt-get install php-xdebug  
   

   或通过PECL安装指定版本：

   sudo pecl install xdebug  
   

2. 配置php.ini
   在/etc/php/[版本]/apache2/php.ini或/etc/php/[版本]/fpm/php.ini中添加：

   zend_extension=xdebug.so  
   xdebug.mode=debug  
   xdebug.start_with_request=yes  
   xdebug.client_host=本地IP（需与PhpStorm所在机器IP一致）  
   xdebug.client_port=9003  # 确保与PhpStorm监听端口一致  
   xdebug.idekey=PHPSTORM  
   

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

   sudo systemctl restart apache2  # 或 nginx/php-fpm  
   

3. 配置PhpStorm远程解释器

   • 打开PhpStorm → Settings → Languages & Frameworks → PHP → CLI Interpreter → 点击齿轮图标 → Add → 选择SSH Interpreter。
   • 输入远程服务器IP、端口、用户名及密码/密钥，选择已安装Xdebug的PHP路径（通常为/usr/bin/php），保存设置。

4. 设置远程部署与路径映射

   • Deployment → Configuration → 选择SFTP，填写远程服务器信息，测试连接后保存。
   • 在Mappings标签页中，将本地项目路径与远程服务器路径（如/var/www/project）一一对应。

5. 启用远程调试

   • 点击PhpStorm右上角电话图标（监听模式），确保端口与xdebug.client_port一致。
   • 在浏览器中访问远程页面时，添加URL参数XDEBUG_SESSION=PHPSTORM（可通过插件一键开启）。
   • 触发代码执行后，PhpStorm会自动暂停在断点处，可查看变量、调用栈等调试信息。

注意事项：

• 确保远程服务器防火墙允许xdebug.client_port（默认9003）的入站连接。
• 若使用Docker或Vagrant，需通过SSH隧道转发端口（参考官方文档）。