新买的一台机器装完环境,php-fpm 一起来就报 Warning: PHP Startup: Unable to load dynamic library 'redis.so',后面跟着 undefined symbol: igbinary_serialize。php -m 里看不到 redis,业务代码一跑就报 Class Redis not found。
第一反应是版本不匹配,phpredis 6.0 和 PHP 8.3 应该是对应的。用 PECL 卸了重装一遍,编译过程没报错,加载还是同样的提示。
用 nm -D 查 redis.so 的符号表,igbinary_serialize 那一行标记是 U,表示未定义,需要运行时从别的库里找。这说明 redis 编译时带了 igbinary 支持,加载时必须保证 igbinary.so 已经先加载,否则符号解析不到,整个扩展直接放弃加载。
nm -D /usr/lib/php/20230831/redis.so | grep igbinary
php -m | grep -E "redis|igbinary"
php --ri igbinary | head -5
php -d extension=igbinary.so -d extension=redis.so -m
翻 php.ini,发现是我自己手工加的两行,先写的 extension=redis.so,后写的 extension=igbinary.so。调换顺序之后重启,两个扩展都出现在 php -m 里,Class Redis not found 也消失了。
但机器上还有另一套用 phpenmod 管理的环境,靠 mods-available 目录里的文件名排序。原来的文件叫 20-redis.ini 和 30-igbinary.ini,排序之后 redis 反而在前。改成 10-igbinary.ini 和 20-redis.ini,再 phpenmod 重新生成软链,问题解决。
验证分两层,命令行用 php -d 显式指定顺序跑一次确认能加载;再起 fpm 用 phpinfo 看 redis 那节的 igbinary support 是否为 enabled。业务侧跑一次 set 加 get,值里带中文和数组,读回来一致。
这类问题在容器镜像里更容易出现,Dockerfile 里几个 extension 的顺序是随手写的,构建能过,运行时才报。现在镜像里统一按依赖顺序写,igbinary、msgpack 在前,redis、mongodb 在后,并且构建的最后一步加 php -m 校验,缺一个就让构建失败。
