ubuntu中php如何进行代码调试

在 Ubuntu 系统下调试 PHP 代码，其实有很多现成的路子可以走。别被“调试”两个字吓住，下面几种方法基本覆盖了从轻量到专业的需求，你可以根据自己的项目规模灵活选。

方法一：用 Xdebug 做断点调试

Xdebug 可以说是 PHP 调试的标配工具。先说安装，Ubuntu 上直接一条命令搞定：

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

装好之后得配置一下 php.ini。文件位置看你的 PHP 版本和运行方式，一般是在 /etc/php/{php_version}/cli/php.ini 或 /etc/php/{php_version}/fpm/php.ini 里。在文件末尾加上这几行：

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 端口，并且一有请求就自动触发调试。之后你就可以打开 Visual Studio Code、PhpStorm 这类 IDE，设置好断点，边跑边看了。对于大型项目，这招效率最高。

方法二：用 PHP 内置服务器 + 错误报告

如果只是开发阶段小范围测试，完全没有必要搞复杂的 Xdebug。PHP 自带了一个简易的 Web 服务器，在项目根目录跑个命令就能启动：

php -S localhost:8000 -t public

这里 -t public 指定了公共目录，你也可以改成自己的入口目录。然后打开浏览器访问 http://localhost:8000 就能看到应用了。配合开启错误报告，哪里有问题一目了然。

在 php.ini 里把这两项解注释（删掉前面的分号）：

display_errors = On
error_reporting = E_ALL

这样所有错误都会直接显示在页面上，方便快速定位。

方法三：靠日志记录抓问题

有些场景下你不想在浏览器里暴露错误信息，或者需要事后追踪，那就用日志记录。PHP 的 error_log() 函数用起来很简单：

if ($error) {
    error_log("Error message: " . $error_message, 0);
}

第二个参数 0 表示把消息写到系统默认的日志文件里，比如 Apache 的 /var/log/apache2/error.log 或 Nginx 的 /var/log/nginx/error.log。这样即使页面正常显示，你也能在后台抓到错误线索。

现在总结一下：大项目、需要断点跟踪的，首选 Xdebug + IDE；小项目、快速验证，直接用内置服务器加错误显示；生产环境或需要长期追踪的问题，日志记录是必备手段。三种方法各有侧重，根据实际情况选就是了。