首先确认缺失的扩展名称，如ext-imagick；然后通过php -m检查已加载扩展，使用系统包管理器或PECL安装对应扩展，最后在php.ini中启用并重启服务验证。

的错误。这表示当前 PHP 环境缺少某个必需的扩展（如 `ext-gd`、`ext-pdo_mysql`、`ext-cURL` 等）。要解决这个问题，你需要安装或启用对应的 PHP 扩展。

确认缺失的扩展名称

composer 错误信息中会明确指出哪个扩展缺失，例如：

The requested PHP extension ext-imagick * is missing from your system.

这里的 ext-imagick 就是需要安装或启用的扩展名。注意区分核心扩展和 PECL 扩展。

检查当前已加载的扩展

运行以下命令查看当前 PHP CLI 环境已启用的扩展：

立即学习“PHP免费学习笔记（深入）”；

php -m

如果在列表中找不到提示缺失的扩展，说明尚未启用或未安装。

同时确认你使用的是正确的 PHP 配置文件：

php --ini

这能帮助你找到 php.ini 文件位置，确保你在正确的位置进行配置修改。

根据系统安装或启用扩展

不同操作系统安装 PHP 扩展的方式略有不同：

ubuntu / debian 系统

• 使用 apt 搜索并安装扩展，例如安装 GD 扩展：

sudo apt search php | grep gd
• 然后安装对应版本的扩展包（如 PHP 8.1）：

sudo apt install php8.1-gd
• 其他常见扩展示例：

sudo apt install php8.1-mysql   # PDO MySQL sudo apt install php8.1-curl    # cURL sudo apt install php8.1-xml     # XML / DOM sudo apt install php8.1-zip     # ZipArchive

centos / RHEL / Fedora

Is This Image NSFW?

图片安全检测，AI分析图像是否适合安全工作

49

查看详情

• 使用 yum 或 dnf 安装扩展：

sudo dnf install php-gd sudo dnf install php-mysqli sudo dnf install php-pecl-zip

macos（使用 Homebrew）

• 如果你通过 brew 安装 PHP：

brew install php@8.1 brew install php@8.1-gd  # 某些扩展可能需单独安装
• 注意：部分扩展需通过 PECL 安装。

windows 系统

• 打开你的 php.ini 文件（通常位于 PHP 安装目录）。
• 查找类似 ;extension=gd 的行，去掉前面的分号启用：

extension=gd extension=mysqli extension=curl
• 确保对应 DLL 文件存在于 ext/ 目录中。若无，需从 PECL for Windows 下载并放入目录。

处理 PECL 扩展（如 imagick、redis、swoole）

某些扩展不在系统包管理器中提供，需通过 PECL 安装：

pecl install imagick pecl install redis

安装完成后，在 php.ini 中添加：

extension=imagick.so  ; linux/macOS extension=php_imagick.dll  ; Windows

安装 PECL 扩展前，确保已安装编译工具和开发库：

• Ubuntu/Debian：

sudo apt install php-dev php-pear build-essential
• CentOS：

sudo dnf install php-devel php-pear gcc

验证修复结果

安装并启用扩展后，重启 Web 服务器（如 apache 或 nginx）或 PHP-FPM 服务：

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

再次运行：

php -m | grep 扩展名

确认扩展已加载。然后重新执行 Composer 命令：

composer install

错误应已消失。

基本上就这些。关键是搞清楚缺失的是哪个扩展，然后在对应系统上正确安装并启用它。环境一致性很重要，特别是开发与生产环境之间。不复杂但容易忽略。

以上就是