composer "requires ext-sodium" 缺少 libsodium 扩展怎么办？

答案：解决Composer报错requires ext-sodium需确保PHP版本≥7.2并启用sodium扩展。1. 检查PHP版本：php -v；2. 查看扩展是否启用：php -m | grep sodium；3. 编辑php.ini取消注释或添加extension=sodium（Windows为extension=php_sodium.dll）；4. Linux可尝试sudo apt-get install php-sodium等命令安装；5. 验证：php -r "var_dump(extension_loaded('sodium'));"返回true即成功，再运行composer install。

如果你在使用 Composer 安装或更新 PHP 项目时遇到 "requires ext-sodium" 错误，说明项目依赖了 PHP 的 sodium 扩展，但当前环境中未安装或启用该扩展。sodium 是用于现代加密操作的 PHP 扩展，自 PHP 7.2 起已内置，通常不需要额外安装 C 库（如 libsodium），但需要确保扩展已启用。

1. 确认 PHP 版本是否支持 Sodium

检查 PHP 版本：

php -v

2. 检查 sodium 扩展是否已启用

运行以下命令查看是否已加载 sodium 扩展：

php -m | grep sodium

解决方法：

MagicStudio

图片处理必备效率神器！为你的图片提供神奇魔法

102

查看详情

• 打开对应的 php.ini 文件（可通过 php --ini 查看路径）
• 查找并取消注释这行（如果存在）：
  ;extension=sodium → extension=sodium
• 如果没有这行，直接添加：extension=sodium
• 保存后重启 Web 服务器或 PHP-FPM

3. Linux 系统下通过包管理器安装（如未内置）

Ubuntu/Debian：

sudo apt-get install php-sodium

CentOS/RHEL（需 EPEL 或 Remi 源）：

sudo yum install php-sodium

sudo dnf install php-sodium

4. Windows 用户处理方法

• 编辑 php.ini
• 确保 extension=php_sodium.dll 存在且未被注释
• 确认 PHP 安装目录下的 ext/ 文件夹中存在 php_sodium.dll
• 如缺失，可能是 PHP 版本问题，建议从 windows.php.net 下载完整包

5. 验证是否成功

php -r "var_dump(extension_loaded('sodium'));"

然后重新运行 Composer 命令：

composer install

以上就是composer "requires ext-sodium" 缺少 libsodium 扩展怎么办？的详细内容，更多请关注php中文网其它相关文章！