如何调试Ubuntu PHP代码

在Ubuntu上调试PHP代码：告别“盲人摸象”

调试PHP代码，尤其是在服务器环境下，如果只靠“打印日志”和“凭感觉猜”，那感觉就像在迷宫里摸黑走路。好在，我们有Xdebug这个强大的工具。今天，我们就来手把手搞定在Ubuntu系统上配置Xdebug，让你能像在本地IDE里一样，优雅地进行断点调试、变量观察。

第一步：安装Xdebug扩展

万事开头难？其实一点也不。打开你的终端，运行下面这两条命令，安装过程基本就搞定了。

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

第二步：配置PHP以启用Xdebug

安装完成后，关键的一步是修改PHP配置文件。首先，你得找到正确的php.ini文件。它通常因运行环境（命令行CLI或Web服务器）而异，路径大概是：

• CLI模式：/etc/php/{php_version}/cli/php.ini
• Apache2：/etc/php/{php_version}/apache2/php.ini

如果不确定，一个简单的命令就能帮你定位：

php --ini

找到文件后，用你熟悉的编辑器（比如nano）打开它：

sudo nano /etc/php/{php_version}/cli/php.ini

然后，将以下配置追加到文件末尾。这几行配置是激活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通过本地的9003端口与你的IDE通信。保存并关闭文件即可。

第三步：重启Web服务让配置生效

配置改完了，别忘了重启服务，新设置才能起作用。根据你使用的Web服务器，执行对应的命令：

如果你用的是Apache2：

sudo systemctl restart apache2

如果你用的是Nginx（通常搭配PHP-FPM）：

sudo systemctl restart php{php_version}-fpm
sudo systemctl restart nginx

第四步：在IDE中配置调试器

服务器端准备好了，现在轮到你的“作战指挥部”——也就是代码编辑器。这里以Visual Studio Code为例。

首先，去VSCode的扩展市场搜索并安装“PHP Debug”这个官方扩展。

接着，在你的项目根目录下，创建或编辑.vscode/launch.json文件，放入以下配置：

{
  "version": "0.2.0",
  "configurations": [{
    "name": "Listen for Xdebug",
    "type": "php",
    "request": "launch",
    "port": 9003,
    "pathMappings": {
      "/var/www/html": "${workspaceFolder}"
    }
  }]
}

这里有个关键点：pathMappings部分。你需要把示例中的/var/www/html替换成你Ubuntu服务器上项目的实际目录路径。这一步是为了让IDE知道，你本地项目的文件对应服务器上的哪个位置。

第五步：开始你的调试之旅

至此，所有桥梁都已架设完毕。现在，你可以在VSCode中打开你的PHP文件，在行号旁边点击设置断点，然后点击“开始调试”按钮（或按F5），切换到“监听Xdebug”模式。

接下来，神奇的事情发生了：当你通过浏览器访问对应的网页，或者运行CLI脚本时，代码执行到断点处就会自动暂停。此时，你可以查看所有变量的实时状态，逐行执行代码，彻底告别“盲猜”时代。

最后提一句，Xdebug的功能非常丰富，上述配置是最基础的调试设置。如果你需要性能分析、代码覆盖率检查等高级功能，去翻翻Xdebug的官方文档，那里有更详细的参数说明。现在，去享受流畅的调试体验吧。