Debian怎么装PHP扩展

在 Debian 上安装 PHP 扩展一般有两种常见方式：用 apt 安装（推荐） 和 用 pecl/源码编译安装。下面按场景说明。

一、先确认 PHP 版本

php -v

或

php -v | head -n1

如果你用的是 PHP 8.1：

php8.1 -v

二、用 apt 安装 PHP 扩展（最简单、最推荐）

1️⃣ 更新软件源

sudo apt update

2️⃣ 安装扩展（以 PHP 8.1 为例）

格式一般是：

sudo apt install php8.1-扩展名

常见扩展示例：

sudo apt install php8.1-mysql
sudo apt install php8.1-curl
sudo apt install php8.1-gd
sudo apt install php8.1-mbstring
sudo apt install php8.1-xml
sudo apt install php8.1-zip

如果是默认 PHP（系统默认版本）：

sudo apt install php-mysql php-curl php-gd

3️⃣ 重启 Web 服务

Apache：

sudo systemctl restart apache2

Nginx + PHP-FPM：

sudo systemctl restart php8.1-fpm

4️⃣ 验证

php -m | grep 扩展名

例如：

php -m | grep curl

三、用 pecl 安装扩展（如 Redis、Swoole 等）

1️⃣ 安装必要工具

sudo apt install php-dev php-pear

如果是特定版本：

sudo apt install php8.1-dev php-pear

2️⃣ 用 pecl 安装

例如 Redis：

sudo pecl install redis

安装完成后会提示你添加：

extension=redis.so

3️⃣ 启用扩展

sudo bash -c 'echo "extension=redis.so" > /etc/php/8.1/mods-available/redis.ini'
sudo phpenmod redis

4️⃣ 重启服务

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

四、常见问题

❓ 找不到 php8.x 包？

先加 Sury PHP 源（常用）：

sudo apt install lsb-release ca-certificates apt-transport-https
sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
sudo sh -c 'echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'
sudo apt update

❓ 不知道扩展叫什么？

apt search php | grep 扩展关键词

如果你告诉我：

Debian 版本（如 11 / 12）
PHP 版本
具体想装哪个扩展（如 redis、swoole、imagick）

我可以直接给你精确命令。