debian php怎样调试错误

在 Debian 下调试 PHP 错误，通常从开启错误显示、查看日志、使用调试工具几个方面入手。下面按实用顺序说明。

一、开启 PHP 错误显示（开发环境）

1. 修改 php.ini

先确认用的是什么 PHP：

php -v
which php

编辑对应 php.ini（常见位置）：

# CLI
/etc/php/8.2/cli/php.ini

# Apache
/etc/php/8.2/apache2/php.ini

# FPM（Nginx）
/etc/php/8.2/fpm/php.ini

修改或确认以下配置：

display_errors = On
display_startup_errors = On
error_reporting = E_ALL
log_errors = On
error_log = /var/log/php/php_errors.log

修改后重启服务：

# Apache
systemctl restart apache2

# Nginx + FPM
systemctl restart php8.2-fpm

2. 在代码中临时开启（不推荐生产）

<?php
error_reporting(E_ALL);
ini_set('display_errors', 1);

二、查看 PHP 错误日志（推荐）

1. PHP 错误日志

tail -f /var/log/php/php_errors.log

如果没有该文件：

mkdir -p /var/log/php
chown www-data:www-data /var/log/php

2. Web 服务器日志

# Apache
tail -f /var/log/apache2/error.log

# Nginx
tail -f /var/log/nginx/error.log

三、常见错误类型及排查

1. 空白页面

通常是：

• 语法错误
• 致命错误未显示

解决：

php -l file.php   # 检查语法

2. 500 错误

查看：

tail -f /var/log/apache2/error.log

或

journalctl -u php8.2-fpm

3. 权限问题

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

四、使用 Xdebug（专业调试）

1. 安装 Xdebug

apt install php-xdebug

2. 配置（FPM 示例）

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

重启 PHP：

systemctl restart php8.2-fpm

3. 配合编辑器

• VS Code（PHP Debug 插件）
• PHPStorm

五、CLI 调试技巧

php -d display_errors=1 script.php
php -d error_reporting=E_ALL script.php

六、生产环境建议

• display_errors = Off
• log_errors = On
• 使用日志监控

如果你能说明：

• Debian 版本
• PHP 版本
• Web 服务器（Apache / Nginx）
• 具体报错信息

我可以给你更精准的调试方案。