Ubuntu下phpstorm如何进行代码调试

Ubuntu下PhpStorm配置PHP代码调试完整步骤

1. 安装Xdebug扩展

在终端中执行以下命令安装Xdebug（适配Ubuntu的包管理）：

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

安装完成后，通过php -v命令确认Xdebug已加载（输出中应包含“with Xdebug”字样）。

2. 配置php.ini文件

找到当前PHP版本的php.ini文件（路径可通过php --ini命令查看，常见位置如/etc/php/8.2/cli/php.ini、/etc/php/8.2/fpm/php.ini），用文本编辑器（如nano）打开并添加以下配置：

[Xdebug]
zend_extension=xdebug.so  # 加载Xdebug扩展（无需手动指定路径，系统会自动查找）
xdebug.mode=debug         # 启用调试模式
xdebug.client_host=127.0.0.1  # 调试客户端地址（本地开发设为127.0.0.1）
xdebug.client_port=9003   # 调试端口（默认9003，需与PhpStorm一致）
xdebug.start_with_request=yes  # 自动启动调试（可选：trigger/yes，推荐yes简化流程）
xdebug.idekey=PHPSTORM    # IDE标识（需与PhpStorm设置一致）

保存文件后，重启Web服务器（Apache/Nginx）和PHP-FPM（若使用）：

# 重启Apache
sudo systemctl restart apache2

# 重启Nginx + PHP-FPM（根据PHP版本调整）
sudo systemctl restart nginx
sudo systemctl restart php8.2-fpm

3. 配置PhpStorm

3.1 设置PHP解释器

打开PhpStorm，点击顶部菜单File > Settings（或Ctrl+Alt+S），导航至Languages & Frameworks > PHP。
点击CLI Interpreter右侧的...，选择Local Path to Interpreter，找到系统PHP路径（如/usr/bin/php），点击OK保存。

3.2 添加Servers配置

在Languages & Frameworks > PHP > Servers中点击+，输入服务器名称（如localhost），设置：

• Host：localhost（本地开发）
• Port：80（HTTP）或443（HTTPS）
• 勾选Use path mappings（路径映射，后续需关联项目目录）。

3.3 配置Debug设置

进入Languages & Frameworks > PHP > Debug，确保：

• Xdebug选项已启用；
• Debug port设置为9003（与php.ini中的client_port一致）；
• 勾选Can accept external connections（允许外部连接，确保调试器能接收请求）。

4. 设置断点

在需要调试的PHP文件中，点击行号左侧的空白区域（如第10行），会出现红色圆圈，表示断点已设置。可设置多个断点，调试时会依次暂停。

5. 启动调试会话

5.1 方式一：直接启动调试

点击PhpStorm顶部工具栏的绿色电话图标（或按Shift+F9），选择已配置的服务器（如localhost），点击OK。此时PhpStorm会进入调试模式，等待请求触发断点。

5.2 方式二：通过Web请求触发

在浏览器中访问目标PHP页面（如http://localhost/your_project/index.php），PhpStorm会在断点处暂停执行。

6. 调试操作

调试启动后，PhpStorm会切换至Debug工具窗口，可进行以下操作：

• Step Over（F8）：执行当前行，跳过函数内部；
• Step Into（F7）：进入当前行的函数内部；
• Step Out（Shift+F8）：跳出当前函数；
• Resume Program（F9）：继续执行至下一个断点；
• Stop（Ctrl+F2）：终止调试会话。
  同时可查看Variables（变量值）、Call Stack（调用堆栈）、Watches（自定义监视变量）等信息。

常见问题排查

• Xdebug未加载：检查php -m是否包含xdebug，php.ini路径是否正确；
• 端口冲突：确保9003端口未被其他程序占用（如netstat -tulnp | grep 9003）；
• 路径映射错误：在Servers配置中，将项目本地路径（如/home/user/project）映射到服务器虚拟路径（如/var/www/html）。

通过以上步骤，即可在Ubuntu系统下使用PhpStorm完成PHP代码的调试。调试过程中可根据需求调整断点位置和调试配置，提升开发效率。