现象
服务器把 PHP 从 8.1 升到 8.3 后,FPM 启动日志出现 PHP Warning: PHP Startup: redis: Unable to initialize module,Module compiled with module API=20220829, PHP compiled with module API=20230831。php -m 里没有 redis,业务连接缓存时直接报 Class "Redis" not found。
原因
PHP 扩展是用 C 编译的动态库,必须和 PHP 主程序的 module API 号完全一致。升级 PHP 后旧的 redis.so 还在 extension_dir 里被 ini 加载,版本对不上就拒绝初始化。另外 PECL 上的 redis 5.x 不支持 PHP 8.3,需要 6.0 以上版本重新编译。
解决步骤
第一步,确认 API 号和扩展位置。对比 PHP 的 API 号与 redis.so 的编译信息,找出残留的旧文件。
php -i | grep -E 'PHP API|extension_dir'
ls -l $(php -r "echo ini_get('extension_dir');")/redis.so
php -v
第二步,按 PHP 版本重装扩展。更新 pecl 频道后安装与 8.3 匹配的 redis 版本,装完确认 ini 里只保留一条 extension=redis.so,避免重复加载。
pecl channel-update pecl.php.net
pecl install redis-6.0.2
echo 'extension=redis.so' > /etc/php/8.3/mods-available/redis.ini
phpenmod -v 8.3 redis
systemctl restart php8.3-fpm
第三步,清理旧版本残留。如果之前用包管理器装过 php8.1-redis,升级后会留下旧 so 和旧 ini,需要一并卸载;确认 conf.d 下没有指向 8.1 目录的软链接,再重启。
验证
php -m 在 CLI 和 FPM 下都能看到 redis,redis 版本号显示 6.0,执行 new Redis() 并 ping 返回 PONG,启动日志不再有 module API 警告。
小结
升级 PHP 必须同步重编所有第三方扩展。先用 API 号确认不匹配,再按版本重装并清理旧文件,不要直接复制旧 so。
