debian php依赖缺失怎么补

debian

小樊

2026-09-11 02:20:37

栏目: 编程语言

在 Debian 上 PHP 依赖缺失，一般按下面思路处理即可。

一、先更新软件源

sudo apt update

如果是老系统，可以先升级一下：

sudo apt upgrade

二、安装 PHP 及常用依赖（以 PHP 8.2 为例）

Debian 12 默认是 PHP 8.2：

sudo apt install php php-cli php-fpm php-mysql php-curl php-gd php-mbstring php-xml php-zip

如果你用的是 Debian 11，默认是 PHP 7.4：

sudo apt install php7.4 php7.4-cli php7.4-fpm php7.4-mysql php7.4-curl php7.4-gd php7.4-mbstring php7.4-xml php7.4-zip

三、缺少某个具体扩展（依赖）

比如提示：

PHP Warning:  Missing extension: mysqli

直接装对应扩展：

sudo apt install php-mysql

常见扩展对照：

curl → php-curl
gd → php-gd
mbstring → php-mbstring
xml → php-xml
zip → php-zip
redis → php-redis
sqlite → php-sqlite3

四、使用第三方 PHP 源（推荐用于新版本）

如果需要 PHP 8.3 / 8.4：

sudo apt install lsb-release ca-certificates apt-transport-https software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.3 php8.3-fpm php8.3-cli

⚠️ 注意：PPA 是 Ubuntu 源，Debian 可用但不官方推荐，生产环境谨慎。

五、Composer 依赖缺失

如果是 PHP 项目 Composer 报错：

composer install

缺扩展就按上面装，装完再：

composer dump-autoload

六、确认 PHP 加载正常

php -m
php -v

七、常见坑

Nginx/Apache 用的 PHP 版本和 CLI 不一致

update-alternatives --set php /usr/bin/php8.2

FPM 没重启
```
sudo systemctl restart php8.2-fpm
```

如果你能贴一下具体的报错信息（比如 apt 或 php 的报错），我可以直接帮你精准补依赖。