准备工作：在Debian上安装Xdebug扩展（远程调试）
要在Debian服务器上实现PHP远程调试，首要步骤就是安装Xdebug扩展。推荐使用系统软件仓库中的稳定版本，兼容性更佳，无需手动编译。这种方法既省时又可靠。
通过以下命令即可完成安装：
sudo apt update
sudo apt install php-xdebug安装完成后，如何验证Xdebug是否已被PHP正确识别？运行以下命令检查：
php -m | grep xdebug
# 应输出"xdebug"如果命令没有输出'xdebug'，可能需要手动配置扩展路径。例如指定路径为/usr/lib/php/20230831/xdebug.so，你可以通过php -i | grep extension_dir查询扩展目录地址。
配置Xdebug：修改php.ini文件实现远程调试
在Debian系统中，PHP的配置文件路径因运行模式而异：Apache环境对应/etc/php/8.2/apache2/php.ini，而PHP-FPM环境则使用/etc/php/8.2/fpm/php.ini。在对应文件末尾添加以下参数：
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=<你的本地IP地址>
# 例如 192.168.1.100（即运行PhpStorm的本地计算机IP）
xdebug.client_port=9003
# 默认监听端口，需与PhpStorm调试端口保持一致
xdebug.start_with_request=yes
# 设置为yes自动启动调试会话，或设为trigger通过Cookie触发
xdebug.idekey=PHPSTORM
# IDE密钥标识，必须与PhpStorm配置一致修改配置后必须重启相关服务使其生效：
sudo systemctl restart php8.2-fpm
# 注意：将PHP版本号替换为你实际使用的版本
sudo systemctl restart apache2配置PhpStorm：设置远程服务器连接与调试参数
首先配置远程服务器连接：导航到File > Settings > Languages & Frameworks > PHP > Servers，点击"+"新增服务器。为其命名（如"Debian-Remote"），连接类型选择SFTP，输入服务器IP地址、SSH端口（默认22）、登录用户名及密码或密钥。关键步骤：在"Mappings"选项卡中，正确设置服务器端项目路径（例如/var/www/html/myproject）与本地项目路径（例如/home/user/myproject），以确保文件自动同步无误。
接下来设置调试端口：进入File > Settings > Languages & Frameworks > PHP > Debug，确保"Debug port"值为9003，与Xdebug配置一致。同时勾选"Use path mappings"选项，保证本地与远程路径映射正确。
启动调试会话：触发方式与操作控制
首先点击PhpStorm顶部工具栏中的绿色电话图标（Start Listening for PHP Debug Connections），图标变为绿色即表示已进入监听状态。
触发调试会话有两种常用方法：使用Chrome或Firefox浏览器的Xdebug Helper插件，一键启用；或者手动在请求URL后附加参数：
?XDEBUG_SESSION_START=PHPSTORM例如：https://your-debian-server/myproject/index.php?XDEBUG_SESSION_START=PHPSTORM
当代码执行到断点时，PhpStorm将自动切换至调试视图。以下常用快捷键请牢记：
- F7：Step Into（步入函数内部查看细节）
- F8：Step Over（跳过函数执行，直接执行下一行）
- F9：Resume Program（继续运行至下一个断点）
- Alt+F8：Evaluate Expression（立即评估任意表达式值）
常见问题排查与调试技巧
调试过程遇到异常？别担心，常见原因通常归纳为以下几点：
- 端口不通：首先检查Debian服务器的防火墙规则，确保
9003端口已开放（执行sudo ufw allow 9003/tcp），同时本地计算机防火墙也需要放行该端口。 - 路径映射错误：断点命中位置不准确，通常是路径映射配置有误。请检查"Deployment"设置中的Mappings选项卡，确保本地路径
/src/controllers与服务器路径/var/www/html/myproject/src/controllers一一对应，不能有任何偏差。 - Xdebug未加载：运行
php -m | grep xdebug确认扩展状态。若未显示，检查php.ini中zend_extension指令的路径是否正确，或尝试重启Web服务器。 - 版本兼容性：Xdebug版本必须与PHP版本兼容。例如PHP 8.2需要Xdebug 3.2及以上版本。可通过
php -v命令查看版本，或在PHP脚本中调用xdebug_info()获取详细信息。
