你不能用 Composer 安装 libsodium 库本身，因为它是一个 C 语言写的系统级加密库，不在 Packagist 上发布；Composer 只能安装 paragonie/sodium_compat 等纯 PHP 兼容层，但无法替代原生 sodium 扩展。
直接说结论：你不能用 Composer 安装 libsodium 库本身——它是一个 C 语言写的系统级加密库，不是 PHP 包。Composer 只能安装 paragonie/sodium_compat 这类纯 PHP 的兼容层，或者依赖它的上层封装（如 defuse/php-encryption），但**无法替代原生 sodium 扩展**。
为什么 composer require libsodium 会失败
因为 libsodium 不在 Packagist 上发布为 Composer 包。你在终端执行：
composer require libsodium
只会得到 Could not find package libsodium 或类似提示。这不是网络或配置问题，而是根本不存在这个包。
-
libsodium是底层 C 库，需通过系统包管理器（apt、yum、dnf）或源码编译安装 - PHP 的
sodium扩展是 PHP 源码的一部分（7.2+ 内置），但它依赖系统已安装的libsodium运行时库 -
paragonie/sodium_compat才是 Composer 可安装的包，它在没原生扩展时提供函数别名，但性能差、不支持全部 API（比如sodium_crypto_kx部分函数缺失）
正确路径：先装系统库，再确认 PHP 扩展
不要跳过这步直接 composer require 兼容层——那只是兜底方案，不是正解。优先启用原生扩展：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
立即学习“PHP免费学习笔记（深入）”；
- Ubuntu/Debian：
sudo apt install libsodium23（不是libsodium-dev） - CentOS/RHEL/AlmaLinux：
sudo dnf install libsodium（CentOS 7 用yum install libsodium，确保 EPEL 启用） - 验证是否装好：
ldconfig -p | grep sodium应输出类似libsodium.so.23的条目 - 再检查 PHP 是否真正可用：
php -r "var_dump(function_exists('sodium_crypto_secretbox'));"返回bool(true)才算成功
什么时候才该用 composer require sodium_compat
仅当你的环境明确无法启用原生 sodium 扩展时（例如：PHP 版本
- 运行：
composer require paragonie/sodium_compat - 注意：它会自动注册函数别名（如
sodium_crypto_secretbox），但前提是 PHP 中没有已加载的原生sodium扩展——两者共存会导致冲突或静默失效 - 调用时别直接写
sodium_crypto_secretbox()，改用命名空间方式更稳妥：Sodium\crypto_secretbox() - 性能比原生低 3–5 倍，且部分新函数（如
sodium_crypto_pwhash_str_verify）在旧版 compat 中不可用
常见混淆点：sodium 扩展 ≠ sodium_compat 包
很多人看到 composer require paragonie/sodium_compat 成功，就以为“装好了 sodium”，结果一跑 sodium_crypto_secretbox_keygen() 就报错。这是因为：
- 原生扩展提供完整、高性能的 API；
sodium_compat是模拟实现，功能有缺口 - 如果
php.ini里启用了extension=sodium.so，sodium_compat会自动退避——此时它根本不生效 - 错误信息
Call to undefined function sodium_crypto_secretbox的根因永远是：系统库没装 + PHP 扩展没启用，而不是 Composer 没装对包
真正要盯住的是 ldconfig -p | grep sodium 和 php -r "var_dump(function_exists('...'))" 这两个命令的输出，不是 composer install 是否成功。
