phpEnv 不支持直接 pecl install decimal，因其基于源码编译且未集成完整 PECL 运行环境，缺少 phpize 正确路径、头文件及 --with-libmpdec 配置，易报 mpd.h not found；需手动编译并显式指定依赖路径。
phpEnv 本身不支持直接安装 PECL 扩展（如 decimal），必须手动编译加载；若你用 phpEnv 管理多个 PHP 版本，每个版本都要单独处理，且需确保系统已装 libmpdec-dev（Ubuntu/Debian）或 mpdecimal-devel（CentOS/RHEL）。
为什么 phpEnv 没有 pecl install decimal 这条路
phpEnv 是基于源码编译的 PHP 版本管理器，它不集成 PECL 包管理器运行时环境——也就是说，pecl 命令即使存在，也常因缺少 phpize 路径、头文件或 pkg-config 支持而失败。你执行 pecl install decimal 很可能卡在 configure: error: mpd.h not found 或类似提示。
- phpEnv 编译的 PHP 默认不带
--with-libmpdec，而decimal扩展强依赖 libmpdec C 库 -
pecl install会尝试调用当前phpize，但 phpEnv 下不同 PHP 版本的phpize可能指向错误路径 - 即使编译成功，生成的
decimal.so也未必能被该 PHP 实例识别（扩展 ABI 不匹配很常见）
手动编译 decimal 扩展并启用的实操步骤
以 phpEnv 当前激活的 PHP 版本（比如 8.2.15）为例，进入其源码构建目录操作：
- 先确认已安装底层依赖：
sudo apt install libmpdec-dev build-essential（Ubuntu/Debian）或sudo yum install mpdecimal-devel gcc make（CentOS/RHEL） - 从 GitHub 克隆扩展源码：
git clone https://github.com/moneyphp/php-decimal.git && cd php-decimal - 用当前 phpEnv 的
phpize初始化（关键！别用系统默认的）：/path/to/phpenv/versions/8.2.15/bin/phpize - 配置时显式指定 libmpdec 路径（避免找不到头文件）：
./configure --with-php-config=/path/to/phpenv/versions/8.2.15/bin/php-config --with-libmpdec=/usr - 编译安装：
make && sudo make install，成功后会输出类似Installing shared extensions: /path/to/phpenv/versions/8.2.15/lib/php/extensions/no-debug-zts-20220829/ - 编辑该 PHP 版本的
php.ini（通常在/path/to/phpenv/versions/8.2.15/etc/php.ini），添加：extension=decimal.so - 验证：
phpenv local 8.2.15 && php --re decimal应输出扩展信息，无报错即生效
货币计算必须配的三项精度控制
decimal 扩展默认 scale 是 28，但金融场景下必须显式约束，否则 $a->add($b) 可能返回 12 位小数的结果，后续格式化或数据库写入会出问题。
立即学习“PHP免费学习笔记（深入）”；
- 全局设上下文（推荐封装）：
Decimal\Context::setDefault(new Decimal\Context(2, Decimal\ROUND_HALF_UP))—— 这会让所有新 Decimal 实例默认保留 2 位小数、四舍五入 - 构造时指定精度：
new Decimal('19.99', 2)，注意第二个参数是 scale，不是字符串长度 - 运算后强制缩放：
$result->scale(2)，不能省略，因为mul()或div()可能扩大 scale（例如'1.23' * '4.567'默认得 5 位）
漏掉 scale(2) 是最常踩的坑：前端显示「¥19.990000」或数据库存入超长小数，都不是 bug，是没调用缩放。
和 BCMath 混用时要注意什么
不要把 Decimal 对象直接传给 bcadd() 等函数——它们只认字符串或数字，传对象会触发 __toString()，但默认不保证小数位数，可能截断或补零不一致。
- 安全做法：统一转字符串并显式格式化：
$decimal->toString('f', 2)（输出如"19.99"）再喂给 BCMath - 反向亦然：BCMath 结果用
new Decimal($bc_result)构造，而非new Decimal((float)$bc_result)，后者又掉回浮点陷阱 - 性能上，decimal 在纯十进制运算中比 BCMath 快约 2–3 倍（benchmark 数据见项目
benchmarks/目录），但混合调用反而拖慢，建议选一个主干方案贯穿到底
真正难的是 scale 传播逻辑——加减法继承最大 scale，乘除法按规则叠加，这些细节不看源码里的 mpd_qadd 调用很难推演，所以别靠猜，一律 ->scale(N) 收尾。
