debian php为什么报错

“Debian 上 PHP 报错”是一个比较宽泛的问题，因为报错原因有很多，而且不同场景（Web 访问、命令行、安装、升级）报错完全不同。

下面我按常见场景 + 典型报错 + 解决办法给你梳理一下，你可以对照自己的情况。

一、最常见：PHP 页面访问 500 / 白屏

1️⃣ PHP 模块没启用（Apache）

现象

• 访问 .php 直接下载或 500
• 日志：Invalid command 'php'

解决

sudo apt install libapache2-mod-php
sudo a2enmod php
sudo systemctl restart apache2

2️⃣ PHP 版本和模块不匹配

现象

• 命令行 php -v 正常
• 网页仍然不解析

解决

php -v
ls /etc/apache2/mods-enabled/ | grep php

如果版本不一致：

sudo a2dismod php7.4
sudo a2enmod php8.2
sudo systemctl restart apache2

3️⃣ 权限问题（非常常见）

现象

• Permission denied
• 日志在 /var/log/apache2/error.log

解决

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

二、命令行 PHP 报错

1️⃣ php: command not found

sudo apt install php-cli

2️⃣ 缺扩展

现象

Class 'mysqli' not found

sudo apt install php-mysql
sudo systemctl restart apache2

常用扩展：

php-curl php-gd php-mbstring php-xml php-zip

三、PHP-FPM + Nginx 报错

1️⃣ 502 Bad Gateway

原因

• php-fpm 没运行
• socket 路径不对

systemctl status php8.2-fpm

Nginx 配置示例：

fastcgi_pass unix:/run/php/php8.2-fpm.sock;

四、升级 Debian / PHP 后报错

1️⃣ 旧代码不兼容

• php8.0+ 移除了很多旧写法
• each()、create_function() 已删除

查错误：

php -l file.php

五、如何快速定位错误（非常重要）

看错误日志

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

# Nginx + PHP-FPM
tail -f /var/log/php8.2-fpm.log

临时打开错误显示（开发环境）

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

六、你可以这样告诉我，我能精准帮你

请把以下信息发我：

1. Debian 版本（cat /etc/os-release）
2. PHP 版本（php -v）
3. Web 服务（Apache / Nginx）
4. 完整报错信息（复制）
5. 是网页报错还是命令行报错

我可以直接帮你“对症修”。