Debian系统中PHPStorm的调试功能怎么用

Debian 上用 PhpStorm 开启 PHP 调试的实用步骤

一 环境准备与安装 Xdebug

• 确认 PHP 版本：php -v；安装对应版本的 Xdebug（Debian 常用 apt 安装）。
• 安装命令示例：sudo apt-get update && sudo apt-get install php-xdebug。
• 找到正确的 php.ini：
  • Web 环境：/etc/php/<版本号>/apache2/php.ini 或 /etc/php/<版本号>/fpm/php.ini
  • CLI 环境：/etc/php/<版本号>/cli/php.ini
• 建议先备份原配置：sudo cp /etc/php/<版本号>/apache2/php.ini /etc/php/<版本号>/apache2/php.ini.bak。

二 配置 Xdebug 3 与 PhpStorm 基础

• php.ini 关键配置（Xdebug 3 推荐）：

  [Xdebug]
  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
  

  • 说明：client_host 填运行 PhpStorm 的机器 IP；若 PHP 与 IDE 在同一台 Debian 机器，用 127.0.0.1。
• 重启服务使配置生效：
  • Apache：sudo systemctl restart apache2
  • PHP-FPM：sudo systemctl restart php**<版本号>**-fpm
• PhpStorm 设置：
  • File → Settings → Languages & Frameworks → PHP → Debug：将 Debug port 设为 9003（与 php.ini 一致）。
  • File → Settings → Languages & Frameworks → PHP → Servers：新增服务器，填写 Host/Port，Debugger 选 Xdebug；如为远程项目，开启并配置 路径映射（本地项目路径 ↔ 服务器绝对路径）。

三 本地与远程调试的两种常用方式

• 方式 A 浏览器触发（GET 参数或 Cookie）
  1. 在 PhpStorm 中点击工具栏“电话”图标，开启监听。
  2. 浏览器访问目标 URL，附加调试会话：
     • 在 URL 后追加：?XDEBUG_SESSION_START=PHPSTORM
     • 或使用浏览器插件（如 Xdebug Helper）设置 Cookie：XDEBUG_SESSION=PHPSTORM
  3. 命中断点后，PhpStorm 自动进入调试视图（变量、堆栈、单步等）。
• 方式 B 一键启动内置服务器调试（适合本机开发）
  1. Run → Edit Configurations → 新建 PHP Built-in Web Server：指定 Document root 与端口（如 8000），并选择上一步配置的 Server。
  2. 在代码中设置断点，点击调试运行；PhpStorm 会启动内置服务器并自动监听连接。

四 常见问题排查与实用建议

• 端口连通性：确保 9003 未被占用且防火墙放行；必要时在路由器做 9003 的端口映射（跨网段调试）。
• 多版本 PHP：确认修改的是实际使用的 SAPI 的 php.ini（如 apache2/fpm/cli），并重启对应服务。
• 路径映射：远程调试务必正确设置 Absolute path on the server，否则断点无法命中。
• 日志定位：在 php.ini 临时开启 xdebug.log 输出，便于排查握手与连接问题。
• 旧版兼容：若使用 Xdebug 2，常见配置为 xdebug.remote_enable=1、xdebug.remote_port=9000、xdebug.remote_host=…；与 Xdebug 3 的 mode/port 体系不同。