php -m 看不到刚装的扩展,扩展没生效怎么排查

现象:装完了,列表里就是没有

按文档编译安装了 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" 对齐后,再去装对应版本的包,可以省掉一轮折腾。

您可以还会对下面的文章感兴趣: