在PHP扩展中使用C++ MPFR库时报未定义符号mpfr_get_emin_min错误

基础开发场景 #

开发基于MPFR动态库的自定义PHP扩展，内置两个基础功能模块：

• 测试用ping函数，返回固定字符串pong，用于快速验证扩展是否被PHP正常加载
• 版本查询函数，预期输出运行时MPFR库版本、编译时绑定的MPFR头文件版本信息，对应代码片段：

return ("MPFR library: %-12s\nMPFR header:  %s (based on %d.%d.%d)\n",
            mpfr_get_version(), MPFR_VERSION_STRING, MPFR_VERSION_MAJOR,
            MPFR_VERSION_MINOR, MPFR_VERSION_PATCHLEVEL);

整个扩展编译流程无报错，生成的.so文件复制到PHP扩展目录后，运行测试脚本触发加载错误：undefined symbol: mpfr_get_emin_min

已执行的排查操作 #

• 初步判断扩展未正确关联MPFR动态库，在编译命令末尾追加链接参数-lmpfr -lgmp，重新编译后加载错误仍未解决
• 代码中通过标准语法引入#include <mpfr.h>头文件，编译流程可正常通过，确认头文件引入路径、语法无问题

核心问题排查方向 #

• 头文件与动态库版本错配：编译时引入的mpfr.h是高版本MPFR的头文件，但PHP运行时实际加载的libmpfr.so是旧版本，旧版本库中根本不存在mpfr_get_emin_min这个接口的实现，因此触发符号未定义错误。这种情况下哪怕编译时加了链接参数，只要PHP进程启动时动态库搜索路径优先命中旧版MPFR，错误就不会消失。
• 手动添加的链接参数未生效：PHP扩展的编译流程是通过phpize生成的Autoconf配置完成的，直接在手动编译命令末尾加-lmpfr -lgmp，没有把MPFR的依赖关系、库搜索路径写入扩展的正式链接配置，最终生成的.so没有绑定对应MPFR库的关联关系，加载时不会主动去匹配正确版本的MPFR库。
• 多版本MPFR的路径冲突：系统同时安装了多套MPFR，编译时链接的是某一路径下的新版MPFR，但PHP运行时的动态库搜索路径优先级更高的位置放了旧版MPFR，加载时直接命中旧版本库，找不到对应符号。

快速验证操作：执行ldd 生成的mpfr.so查看扩展实际关联的libmpfr.so路径，再执行nm -D 对应路径的libmpfr.so | grep mpfr_get_emin_min检查该动态库中是否存在缺失的符号，即可快速定位版本错配问题。

内容的提问来源于stack exchange，提问作者Tyralcori