温馨提示×

ubuntu phpstorm支持xdebug吗

小樊
41
2026-10-16 16:22:46
栏目: 编程语言

是的,Ubuntu 上的 PhpStorm 完全支持 Xdebug,而且这是 PHP 开发中非常常见、官方推荐的组合。

下面给你一个清晰说明:


一、PhpStorm 在 Ubuntu 下对 Xdebug 的支持情况

✅ 支持

  • PhpStorm(JetBrains)原生支持 Xdebug
  • 支持 Xdebug 2 / Xdebug 3
  • 支持:
    • 断点调试
    • 单步执行
    • 变量查看
    • 远程调试(CLI / Web)
    • 多项目、Docker、虚拟机调试

✅ 运行环境

  • Ubuntu 20.04 / 22.04 / 24.04 均可用
  • PHP 7.x / 8.x 均可

二、典型使用方式(Ubuntu + PhpStorm + Xdebug)

1️⃣ 安装 Xdebug(Ubuntu)

sudo apt install php-xdebug

或(PHP 8+):

sudo apt install php8.1-xdebug

2️⃣ 配置 php.ini(示例 Xdebug 3)

[xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.idekey=PHPSTORM

重启 PHP:

sudo systemctl restart apache2
# 或
sudo systemctl restart php8.1-fpm

3️⃣ PhpStorm 配置

  1. Settings → PHP → Debug
    • Debug port: 9003
  2. Settings → PHP → Servers
    • 添加本地服务器(如 localhost)
  3. 开启:
    • “Start Listening for PHP Debug Connections”
  4. 浏览器安装:
    • Xdebug Helper(Chrome / Firefox)

三、常见调试方式

场景 支持
Web 页面调试 ✅
CLI 脚本调试 ✅
Laravel / Symfony ✅
Docker 内 PHP ✅(需端口映射)
远程服务器 ✅

四、常见问题

❓ PhpStorm 打不开 Xdebug?

  • 检查 php -m | grep xdebug
  • 检查端口是否被占用
  • 查看 PhpStorm Debug 日志

❓ Docker 里能用吗?

  • 可以,推荐 client_host=host.docker.internal

五、总结

✅ Ubuntu + PhpStorm + Xdebug = 完全支持,体验非常好

如果你需要:

  • Ubuntu + Docker + Xdebug 配置
  • CLI 调试示例
  • Laravel 调试配置

可以直接告诉我你的环境,我可以给你一份可直接用的配置。

0 踩