ubuntu php为啥报错

“Ubuntu 上 PHP 报错”原因非常多，不同场景报错完全不同。先给你最常见的几类原因 + 排查方法，你可以对照看；如果还不行，把具体报错信息贴出来我可以直接帮你定位。

一、最常见原因汇总

1️⃣ PHP 没装 / 版本不对

php -v

如果提示：

Command 'php' not found

说明没装：

sudo apt update
sudo apt install php php-cli

2️⃣ Web 环境没配对（Apache / Nginx）

Apache

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

Nginx

Nginx 不自带 PHP，必须装 PHP-FPM：

sudo apt install php-fpm

并确认 nginx.conf 或站点配置里有：

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

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

报错类似：

Permission denied

解决：

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

4️⃣ 缺扩展

例如：

Class 'mysqli' not found

安装扩展：

sudo apt install php-mysql
sudo systemctl restart apache2   # 或 php-fpm

5️⃣ 配置文件错误

查看真正报错：

sudo tail -n 50 /var/log/apache2/error.log
# 或
sudo tail -n 50 /var/log/nginx/error.log

6️⃣ PHP 语法错误

本地先测：

php index.php

如果有语法错误会直接显示。

二、快速自检清单 ✅

你可以依次检查：

• [ ] php -v 能跑
• [ ] Web 服务已重启
• [ ] 报错日志看了
• [ ] 文件权限正确
• [ ] 需要的扩展已安装

三、你可以这样告诉我（更快解决）

直接贴：

1. 完整报错信息
2. 用的什么（Apache / Nginx）
3. Ubuntu 版本
4. PHP 版本（php -v）

我可以直接帮你给出精确解决方案。