debian php报错如何排查

debian

小樊

2026-09-11 02:16:37

栏目: 编程语言

在 Debian 上排查 PHP 报错，一般可以按下面思路一步一步来。

一、确认 PHP 是否正常工作

php -v

如果报错：

command not found：未安装或没在 PATH

安装 PHP：

sudo apt update
sudo apt install php-cli

二、查看 PHP 错误信息来源

1️⃣ 命令行 PHP 报错

php /path/to/script.php

直接看终端输出。

2️⃣ Web 环境（Apache / Nginx + PHP-FPM）

页面空白或 500 错误时：

Apache

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

Nginx + PHP-FPM

sudo tail -f /var/log/nginx/error.log
sudo tail -f /var/log/php7.x-fpm.log

（版本号按实际，如 php8.2-fpm）

三、开启 PHP 错误显示（调试用）

临时在脚本里加

ini_set('display_errors', 1);
error_reporting(E_ALL);

修改 php.ini（推荐）

找到 php.ini：

php --ini

常见位置：

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

修改：

display_errors = On
error_reporting = E_ALL

重启服务：

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

四、常见 PHP 报错及排查

1️⃣ 500 Internal Server Error

看 Web 错误日志
一般是语法错误 / 权限问题

2️⃣ Permission denied

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

3️⃣ Module not found

如：

Class 'PDO' not found

安装扩展：

sudo apt install php8.2-mysql php8.2-curl php8.2-mbstring

4️⃣ 版本不兼容

php -v

确认框架要求的 PHP 版本。

五、快速排查 checklist

✅ php -v 正常
✅ 错误日志已查看
✅ display_errors 已开
✅ 文件权限正确
✅ 必要扩展已安装
✅ Web 服务已重启

如果你能贴出：

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

我可以帮你更精确定位问题。