phpenv安装PHP时必须显式添加--enable-bcmath编译选项，因bcmath是编译期内置扩展，无法运行时动态加载；若已安装无bcmath的版本，需卸载后修改default_configure_options追加该参数再重装，并分别验证CLI与FPM环境。
phpenv 编译安装 PHP 时必须显式启用 --enable-bcmath
phpenv 本身不提供运行时“开关扩展”的功能，它只负责多版本 PHP 的安装与切换。bcmath 是编译期决定的内置扩展，一旦 PHP 二进制文件编译完成，就无法像宝塔面板那样后期“点按钮安装”。所以关键动作发生在 php-build 编译阶段。
如果你用 phpenv 安装过一个没带 bcmath 的 PHP 版本（比如直接 phpenv install 8.2），那这个版本永远不会有 bcmath —— 即使你手动往 php.ini 里加 extension=bcmath.so，PHP 启动时也会报错：PHP Warning: Unable to load dynamic library 'bcmath.so'，因为根本没生成这个文件。
- 必须卸载旧版本：
phpenv uninstall 8.2 - 设置编译选项：编辑
~/.phpenv/plugins/php-build/share/php-build/default_configure_options，在末尾追加--enable-bcmath - 重新安装：
phpenv install 8.2（此时会自动读取你改过的配置） - 验证：
phpenv local 8.2 && php -m | grep bcmath应输出bcmath
为什么 pecl install bcmath 在 phpenv 环境下大概率失败
PECL 是为用户态扩展设计的，而 bcmath 是 PHP 核心扩展（SAPI-level），它的源码随 PHP 源码一起发布，不在 PECL 仓库中。执行 pecl install bcmath 会提示 No releases available for package "bcmath" 或直接报 404。
即使你强行从第三方源下载了所谓“bcmath.tgz”，它也无法被当前 phpenv 安装的 PHP 加载：模块 ABI 不匹配、缺少依赖符号（如 php_bcmath_module_entry）、或找不到 php_config.h 头文件。
立即学习“PHP免费学习笔记（深入）”；
- 别试
pecl install bcmath—— 它不是设计来干这事的 -
phpize+ 手动编译也行不通：phpenv 安装的 PHP 默认不保留源码目录，ext/bcmath根本不存在 - 唯一可靠路径：重装 PHP，并确保
--enable-bcmath出现在 configure 参数里
确认 CLI 和 Web 环境都生效，不能只看 php -m
phpenv 管理的是 CLI 环境的 PHP，但你的 Web 服务（Nginx + PHP-FPM 或 Apache）很可能用的是系统级或宝塔安装的另一个 PHP 实例。这意味着：php -m | grep bcmath 显示 OK，不代表网站能用 bcadd()。
必须分开验证：
- CLI 验证：
php -r "echo extension_loaded('bcmath') ? 'yes' : 'no';" - FPM 验证：在 Web 目录放一个
info.php，内容为<?php phpinfo(); ?>，浏览器访问后搜索 “bcmath” 和 “Loaded Configuration File”，确认看到模块且 ini 文件路径是你预期的 - 如果 FPM 没启用，得去对应 PHP-FPM 的
php.ini（常位于/etc/php/*/fpm/php.ini或~/.phpenv/versions/8.2/etc/php-fpm.d/www.conf引用的路径）里加extension=bcmath—— 但这仅在该 PHP 已编译支持 bcmath 时才有效
常见报错和对应检查点
遇到 Call to undefined function bcadd()，按顺序排查：
- 运行
which php和php --ini，确认 CLI 用的是 phpenv 切换的版本，且php.ini路径正确 - 查
php -i | grep "bcmath"，无任何输出 = 编译缺失；有输出但没 “enabled” 字样 = 配置未加载或路径错 - Web 报错？立刻看 PHP-FPM 进程实际加载的
php.ini（ps aux | grep php-fpm→ 找 master 进程 →cat /proc/PID/cmdline | tr '\0' '\n'查参数） - 若用 Nginx + php-fpm，重启的是
php-fpm服务，不是 Nginx；改完 ini 必须sudo systemctl restart php*-fpm
最易忽略的一点：phpenv 安装的 PHP 默认不生成 FPM 二进制，它只提供 CLI。你要跑 Web，得用系统包管理器（apt/yum）或宝塔装另一套带 FPM 的 PHP，或自己编译时加 --enable-fpm —— 而这个过程同样要带上 --enable-bcmath。
