现象:装完了,列表里就是没有
按文档编译安装了 redis 扩展,make install 提示成功,但执行 php -m | grep redis 什么都没有,页面里的 phpinfo() 也搜不到。重启服务后依旧是原来的模块列表。
原因:装的位置和读的位置不是同一个
- CLI 和 FPM 用的不是同一个 php.ini。命令行改了,网站跑的是另一套配置,两边表现不一致。
- extension_dir 指向错误目录。so 文件被装到了别的路径,ini 里却按默认目录去找。
- 扩展文件名写错。Linux 下写
extension=redis.so,写成extension=redis在部分版本会失败。 - 依赖库缺失。扩展加载时需要动态库,缺失只在 error_log 里留一行警告,页面完全看不出来。
- 服务没真正重启。只 reload 配置未必重新加载模块,PHP-FPM 需要 restart。
解决步骤
第一步,确认当前进程到底读哪些 ini,这一步能解决大部分困惑:
php --ini
php -i | grep -i extension_dir
页面侧再输出一次 phpinfo(),对比 Loaded Configuration File 是否一致,不一致就说明改错了文件。
第二步,检查文件确实存在,并和 extension_dir 拼起来看:
ls -l $(php -r 'echo ini_get("extension_dir");')
php -m | grep -i redis
第三步,看加载失败的真实原因,警告不会显示在页面上:
php -d display_startup_errors=1 -m 2>&1 | head
如果出现 Unable to load dynamic library,后面通常跟着具体缺哪个 so,装上对应依赖即可。
第四步,重启 FPM 而不只是 reload:
systemctl restart php-fpm
systemctl status php-fpm --no-pager
第五步,容器环境注意镜像分层。在运行中的容器里装扩展,重启容器就丢失了,必须写进 Dockerfile 或挂载持久化目录。
小结
先对齐"改的 ini"和"跑的 ini",再确认 so 路径和依赖,最后重启进程。顺序错了会一直在原地打转。
装扩展前还要确认版本匹配:PHP 8.0 编译的 so 放到 8.2 上加载会直接失败,报错信息同样含糊。用 php -i | grep "PHP Version" 和 php -i | grep "Thread Safety" 对齐后,再去装对应版本的包,可以省掉一轮折腾。
