答案:解决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 7.2 及以上版本默认内置 sodium 扩展,无需额外安装第三方库。如果你使用的是低于 7.2 的版本,建议升级 PHP。检查 PHP 版本:
php -v
2. 检查 sodium 扩展是否已启用
虽然 sodium 内置于 PHP 7.2+,但仍需在 php.ini 中启用。运行以下命令查看是否已加载 sodium 扩展:
php -m | grep sodium如果无输出,说明扩展未启用。
解决方法:
- 打开对应的 php.ini 文件(可通过
php --ini查看路径) - 查找并取消注释这行(如果存在):
;extension=sodium→extension=sodium - 如果没有这行,直接添加:
extension=sodium - 保存后重启 Web 服务器或 PHP-FPM
3. Linux 系统下通过包管理器安装(如未内置)
某些旧版 PHP 或自定义编译环境可能未包含 sodium,可尝试通过系统包安装。Ubuntu/Debian:
sudo apt-get install php-sodium
CentOS/RHEL(需 EPEL 或 Remi 源):
sudo yum install php-sodium或使用 dnf(较新版本):
sudo dnf install php-sodium
4. Windows 用户处理方法
Windows 下通常只需启用扩展:- 编辑 php.ini
- 确保
extension=php_sodium.dll存在且未被注释 - 确认 PHP 安装目录下的
ext/文件夹中存在php_sodium.dll - 如缺失,可能是 PHP 版本问题,建议从 windows.php.net 下载完整包
5. 验证是否成功
执行以下命令确认 sodium 已加载:php -r "var_dump(extension_loaded('sodium'));"
返回 bool(true) 表示成功。
然后重新运行 Composer 命令:
composer install基本上就这些。多数情况下只是忘了启用扩展,不是缺少底层库。只要 PHP 版本 ≥ 7.2,一般无需单独安装 libsodium 开发库。










