Debian PHP错误调试方法

Debian PHP错误调试方法

1. 启用PHP内置错误报告

通过修改php.ini配置文件或代码动态设置，开启错误显示与日志记录。

• 修改php.ini：
  运行php --ini定位php.ini文件（如/etc/php/8.2/apache2/php.ini或/etc/php/8.2/cli/php.ini），编辑并设置以下参数：

  error_reporting = E_ALL      # 报告所有错误类型
  display_errors = On          # 开发环境开启（生产环境建议关闭）
  log_errors = On              # 启用日志记录
  error_log = /var/log/php_errors.log  # 指定日志文件路径
  

• 代码动态设置（适用于无法修改php.ini的情况）：
  在PHP脚本顶部添加：

  ini_set('display_errors', 1);
  ini_set('display_startup_errors', 1);
  error_reporting(E_ALL);
  ini_set('log_errors', 1);
  ini_set('error_log', '/var/log/php_errors.log');
  

• 重启服务：修改后重启Apache（sudo systemctl restart apache2）或PHP-FPM（sudo systemctl restart php8.2-fpm）使配置生效。

2. 查看PHP错误日志

• 默认日志路径：
  • Web模式：/var/log/php_errors.log（自定义路径需与php.ini一致）；
  • CLI模式：错误直接输出到终端；
  • Web服务器日志：Apache的/var/log/apache2/error.log、Nginx的/var/log/nginx/error.log（包含PHP错误转发）。
• 实时查看日志：使用tail命令跟踪日志更新：

  sudo tail -f /var/log/php_errors.log    # 查看PHP专用日志
  sudo tail -f /var/log/apache2/error.log # 查看Apache错误日志
  

3. 使用Xdebug进行高级调试

Xdebug是PHP的强大调试扩展，支持断点、变量监控、单步执行等功能。

• 安装Xdebug：

  sudo apt-get install php-xdebug  # Debian默认仓库安装
  

• 配置Xdebug：
  在php.ini中添加（根据PHP版本调整路径）：

  zend_extension=xdebug.so
  xdebug.mode=debug            # 启用调试模式
  xdebug.client_host=127.0.0.1   # 调试客户端IP（本地为127.0.0.1）
  xdebug.client_port=9003        # 调试端口（默认9003，避免与旧版冲突）
  xdebug.start_with_request=yes  # 自动启动调试（或设为"trigger"手动触发）
  

• 重启服务：sudo systemctl restart apache2或sudo systemctl restart php8.2-fpm。
• IDE集成：使用VS Code（安装PHP Debug扩展）或PhpStorm，配置调试监听端口（如9003），设置断点即可调试。

4. 代码级调试技巧

• 打印变量值：使用var_dump()或print_r()输出变量内容及类型，适用于变量值检查：

  $value = calculateSomething();
  var_dump($value);  // 显示变量类型和值
  

• 命令行调试：通过命令行直接运行脚本，绕过Web服务器配置问题：

  php -d display_errors=1 -d error_reporting=E_ALL script.php  # 强制显示错误
  php -n script.php  # 不加载php.ini文件（用于排查配置冲突）
  

5. 日志轮转管理

避免日志文件过大占用磁盘空间，使用logrotate工具定期轮转日志。

• 创建轮转配置：编辑/etc/logrotate.d/php（若不存在则新建），添加以下内容：

  /var/log/php_errors.log {
      daily                  # 每天轮转
      missingok              # 文件不存在时不报错
      rotate 7               # 保留最近7份日志
      compress               # 压缩旧日志（.gz格式）
      notifempty             # 日志为空时不轮转
      create 640 root adm    # 新日志文件权限
  }
  

• 手动测试轮转：运行sudo logrotate -vf /etc/logrotate.d/php验证配置是否正确。