php 7.4 默认内置 sodium 扩展，但函数不可用常因未真正加载：需用 php -m | grep sodium 验证，且 cli 与 fpm 的 php.ini 路径可能不同，须分别检查并确保 extension=sodium.so 已启用。
PHP 7.4 默认已内置 sodium 扩展，只要系统有 libsodium 库支持，无需手动编译安装 —— 但宝塔或自编译 PHP 环境中常因路径、版本或加载顺序问题导致 sodium_crypto_aead_aes256gcm_encrypt() 等函数不可用。
确认 PHP 是否真已启用 sodium 扩展
别只看 phpinfo() 页面里有没有 “sodium” 标题栏。实际调用失败往往是因为扩展没真正加载成功：
- 运行
php -m | grep sodium，输出sodium才算有效加载；如果无输出，说明未启用 - 检查 CLI 和 FPM 的
php.ini是否为同一份：执行php --ini和php-fpm -i | grep "Loaded Configuration File"，两者路径可能不同 - 在 Web 环境中写个
<?php var_dump(function_exists('sodium_crypto_aead_aes256gcm_encrypt'));，返回false就是函数不可用，不是“扩展存在但没开”就是“开了但被跳过”
宝塔环境下常见 sodium 加载失败原因
宝塔 PHP 7.4+ 虽自带 sodium.so，但默认不自动启用，且容易和手动添加的配置冲突：
-
extension=sodium.so写在php.ini末尾时，若前面已有[sodium]段落或重复extension=行，会触发NOTICE: PHP message: PHP Warning: Module 'sodium' already loaded - 宝塔面板后台「PHP 设置 → 配置文件」里显示的
php.ini路径（如/www/server/php/74/etc/php.ini）必须和php --ini输出一致，否则改了白改 -
sodium.so文件真实路径需核对：ls /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902/sodium.so，不存在就说明宝塔没编译进该模块（极少见），得手动装
手动安装 sodium 扩展的必要条件与关键步骤
仅当 php -m | grep sodium 无输出，且确认系统缺少 libsodium 运行时库时才需手动操作：
- 先装系统级依赖：
yum install epel-release libsodium-devel -y（CentOS 7）或dnf install epel-release libsodium-devel -y（CentOS 8+） - 验证
pkg-config能识别：pkg-config --modversion libsodium应输出类似1.0.18；若报错，需设置PKG_CONFIG_PATH=/usr/local/lib/pkgconfig - 进入宝塔 PHP 源码扩展目录（如
/www/server/php/src/ext/sodium），运行：/www/server/php/74/bin/phpize→./configure --with-php-config=/www/server/php/74/bin/php-config→make && make install - 修改对应
php.ini，**只加一行**：extension=sodium.so（不要加路径，也不要写[sodium]段落）
微信支付等生产场景下必须验证的细节
哪怕 sodium_crypto_aead_aes256gcm_encrypt() 函数存在，也不代表能用于微信小微商户进件等接口：
- 必须调用
sodium_crypto_aead_aes256gcm_is_available()返回true，否则底层 AES-GCM 模式被禁用（常见于 OpenSSL 版本过低或内核禁用 AESNI） - 微信要求 nonce 长度严格为
SODIUM_CRYPTO_AEAD_AES256GCM_NPUBBYTES（12 字节），硬编码random_bytes(12)不可靠，应直接用常量 - 加密后数据需 Base64 编码再传给微信，解密前要先
base64_decode()，漏一步就会 “解密失败”
最易忽略的一点：宝塔重启 PHP 后，必须同时重启 Nginx 或 Apache，否则 Web 请求仍走旧进程，phpinfo() 看到的是新配置，但实际运行的还是老环境。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
