ubuntu php怎样调试

在 Ubuntu 上调试 PHP，常见方式有以下几种，按使用频率和学习成本从易到难说明：

一、最基础：开启错误显示（适合新手）

1. 修改 php.ini

找到 php.ini（位置通常为）：

php --ini

常见路径：

/etc/php/8.1/cli/php.ini
/etc/php/8.1/apache2/php.ini
/etc/php/8.1/fpm/php.ini

修改或确认以下配置：

display_errors = On
error_reporting = E_ALL
log_errors = On

重启服务：

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

二、命令行调试（最快）

1. 直接用 PHP CLI 运行

php -l file.php      # 检查语法
php file.php         # 直接运行

2. 打印调试

var_dump($var);
print_r($var);
exit;

三、使用 Xdebug（强烈推荐，专业调试）

1. 安装 Xdebug

sudo apt install php-xdebug

或（按版本）：

sudo apt install php8.1-xdebug

2. 配置 Xdebug

编辑：

/etc/php/8.1/cli/conf.d/20-xdebug.ini

示例（Xdebug 3）：

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003

3. 配合编辑器

• VS Code
  • 安装：PHP Debug
  • launch.json 使用 Listen for Xdebug
• PHPStorm
  • 直接支持 Xdebug

浏览器访问页面即可断点调试。

四、日志调试（生产环境常用）

error_log(print_r($data, true));

查看日志：

tail -f /var/log/apache2/error.log
# 或
tail -f /var/log/php_errors.log

五、常见问题排查

1. 修改 php.ini 不生效

确认你改的是 CLI 还是 FPM / Apache

php -i | grep php.ini

2. 白屏

• 开启 display_errors
• 查看 error log

推荐组合

✅ 本地开发：Xdebug + VS Code
✅ 线上环境：error_log + 日志监控

如果你愿意，可以告诉我：

• Ubuntu 版本
• PHP 版本
• 用 Apache / Nginx / CLI
• 是否用框架（Laravel / ThinkPHP 等）

我可以给你精确配置步骤。