PHP错误如何在Ubuntu上调试

PHP开发过程中，遇到错误提示是家常便饭。掌握正确的调试方法，能帮你快速定位问题，而不是在日志里大海捞针。开启PHP错误显示，是开发环境中最快最直接的手段。

要启用这个功能，改动php.ini文件就行。首先，通过php --ini命令找到这个文件的具体位置，常见的路径可能是/etc/php/8.2/apache2/php.ini或/etc/php/8.2/fpm/php.ini，这取决于你用的是Apache还是Nginx。然后，用编辑器（比如sudo nano）打开它，找到下面这几个关键参数并修改：

display_errors = On # 开启错误显示
error_reporting = E_ALL # 报告所有类型错误
log_errors = On # 同时记录错误日志
error_log = /var/log/php_errors.log # 可选，自定义日志路径

保存文件后，别忘了重启Web服务器：Apache用户执行sudo systemctl restart apache2；Nginx+PHP-FPM用户则要重启php8.2-fpm和nginx两个服务。这样，PHP的错误信息就会直接输出到浏览器页面，语法错误、未定义变量这类问题一眼就能看到。

不过，在生产环境中，通常不会把错误直接显示在浏览器里。这时候，查看错误日志就成了主力排查手段。默认情况下，Apache的错误日志在/var/log/apache2/error.log，Nginx的在/var/log/nginx/error.log，PHP-FPM自己的日志则在/var/log/php8.2-fpm.log（版本号请以实际为准）。如果你在php.ini里自定义了error_log路径，那就去检查那个文件。

实时跟踪日志更新，可以用tail -f命令，比如：

sudo tail -f /var/log/php_errors.log   # 查看自定义日志
sudo tail -f /var/log/apache2/error.log # 查看Apache日志

日志中会记录详细的错误信息，包括错误类型、发生文件、行号。逻辑错误、数据库连接失败这类问题，往往都能从中找到线索。

遇到更复杂的问题，比如逻辑错误或变量值异常，就该请出专业的调试工具——Xdebug了。它支持断点调试、变量监控和逐步执行。首先要安装扩展：sudo apt-get install php-xdebug（记得根据PHP版本选择包名，比如php8.2-xdebug）。

然后，在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

配置完成后，重启PHP服务。接下来，设置你的IDE（以PhpStorm为例）：进入File > Settings > Languages & Frameworks > PHP > Servers，添加服务器，主机填127.0.0.1，端口为80或443，勾选“Use path mappings”并映射项目目录。最后，在代码中设置断点，点击IDE的“Start Debugging”按钮，访问对应页面，程序就会在断点处暂停。此时，你可以查看变量值、调用栈，一步步追踪问题根源。

最后，再补充几个常见的辅助排查思路。检查文件权限是个好习惯，确保Web服务器用户（通常是www-data）有权限读取PHP文件和日志目录：

sudo chown -R www-data:www-data /var/www/html
sudo chmod -R 755 /var/www/html

定期更新PHP及扩展也是必要的，sudo apt update && sudo apt upgrade php能帮你修复已知bug。另外，修改php.ini后，用php -c /path/to/php.ini -l命令检查一下语法，可以避免配置错误导致服务启动失败。这些小细节，往往能省下不少排查时间。