phpenv安装PHP时必须在编译阶段通过--with-gmp参数启用GMP支持，因其为内置模块而非动态扩展，装完无法补救；需先装gmp-devel/libgmp-dev，指定路径（如macOS需--with-gmp-dir），验证用php -r "echo extension_loaded('gmp') ? 'yes' : 'no';"。
phpenv 安装 PHP 时必须带上 --with-gmp
phpenv 本身不提供运行时开关扩展的功能，gmp 是编译期决定的内置模块（不是动态加载的 .so），所以不能像 extension=gmp.so 那样后期启用。你必须在用 phpenv install 编译安装 PHP 的那一刻就指定 --with-gmp 参数，否则装完就无法补救。
常见错误是：先装好一个没带 gmp 的 PHP 版本，再试图用 pecl install 或手动编译 gmp.so —— 这完全无效，因为 PHP 源码里根本没启用 GMP 支持，ext/gmp/ 目录压根不会被构建，phpize 也跑不起来。
- 确认系统已装
gmp-devel（CentOS/RHEL）或libgmp-dev（Ubuntu/Debian） - 执行安装时显式传参：
phpenv install 8.1.12 --with-gmp - 如果用的是 macOS + Homebrew 的 gmp，可能还需加
--with-gmp-dir=/opt/homebrew/opt/gmp（Apple Silicon）或--with-gmp-dir=/usr/local/opt/gmp（Intel） - 装完后验证：
phpenv shell 8.1.12 && php -r "echo extension_loaded('gmp') ? 'yes' : 'no';"，输出yes才算成功
为什么 php -m | grep gmp 找不到，但 phpinfo() 里有？
这是典型混淆了“编译支持”和“扩展启用”的表现。如果你看到 phpinfo() 页面里 gmp 栏显示 enabled，但 php -m 列表里没有 gmp，说明你当前 CLI 使用的 PHP 和 Web 服务器（如 nginx + php-fpm）用的不是同一个版本 —— 很可能是 phpenv 切换没生效，或者 php-fpm 服务仍跑在系统默认 PHP 上。
- 查 CLI 当前路径：
which php，确认是否指向~/.phpenv/versions/xxx/bin/php - 查 php-fpm 使用的二进制：
ps aux | grep php-fpm，看 master 进程启动路径 - php-fpm 配置中
php_admin_value[extension]或全局php.ini不能用来“启用”gmp，它只对动态扩展有效；gmp 必须是 PHP 二进制本身带的 - 重启 php-fpm 后，用
php-fpm -t和sudo systemctl restart php-fpm（或对应命令）确保加载新版本
大整数运算报错 gmp_init(): Unable to convert variable to GMP
这不是扩展没开，而是传给 gmp_init() 的参数类型不对。GMP 函数对输入极其敏感：它不接受 float、科学计数法字符串（如 "1e100"）、带空格或非数字字符的字符串，甚至过长的十进制整数字符串在某些 PHP 编译下会溢出为 float 导致转换失败。
立即学习“PHP免费学习笔记（深入）”；
- 安全写法：只传纯数字字符串，且长度可控，例如
gmp_init("12345678901234567890") - 避免：
gmp_init(12345678901234567890)（整型字面量可能被 PHP 自动转成 float） - 避免：
gmp_init(" 123 ")或gmp_init("0xABC")（除非显式指定 base=16） - 调试技巧：用
var_dump(gettype($x), $x)确认输入确实是string类型且无隐藏字符
phpenv 下多个 PHP 版本，gmp 行为不一致？
不同 PHP 小版本对 GMP 的 ABI 兼容性并不完全透明。比如 PHP 8.0.x 默认链接系统 GMP 库，而 PHP 8.1+ 可能启用内部 GMP 实现（取决于 configure 参数和平台），导致 gmp_strval() 输出格式、大数比较行为、甚至内存占用有差异。这不是 bug，而是底层实现切换带来的副作用。
- 不要跨版本假设 gmp 结果完全一致，尤其涉及序列化、缓存或网络传输时
- 生产环境务必锁定 PHP 小版本（如
8.1.12而非8.1），避免自动升级引入隐性变更 - 若需严格一致性，统一用
--with-gmp=shared（编译为独立 so）并固定系统 gmp 版本（如gmp-6.2.1），但这样会失去 phpenv 的便携优势
