PHP CLI与Web环境小数显示不一致本质是precision配置不同,而非PHP计算错误;默认值通常为14,影响serialize/json_encode等函数输出;金额应存字符串或整数,展示用number_format,JSON用JSON_PRESERVE_ZERO_FRACTION,数据库用DECIMAL或PDO::PARAM_STR。

PHP CLI 和 Web 环境小数保存结果不一致,本质是精度配置不同
不是 PHP 本身“算错了”,而是 serialize()、json_encode()、var_dump() 或数据库写入前的类型转换,受 precision 这个 ini 配置影响——而 CLI 和 Web(如 Apache + mod_php 或 FPM)往往加载了不同的 php.ini,导致同一段代码输出看起来“不一样”。
确认当前环境的 precision 值
直接输出查看最可靠,别猜配置文件路径:
php -r "echo ini_get('precision');"
Web 端加一行:
- 默认值通常是
14(PHP 7.1+),但某些 Docker 镜像或 shared hosting 可能设为17或-1(表示用最大可用精度) -
precision = 14意味着浮点数显示/序列化时最多保留 14 位有效数字,不是小数点后 14 位 - 比如
0.1 + 0.2实际是0.30000000000000004,precision=14会显示成0.3,而precision=17会暴露尾部误差
保存小数时真正可控的方法(绕过 precision 干扰)
如果你要“保存”小数(比如入库、写 JSON、传给前端),靠调整 precision 是治标。应该明确数据意图:
立即学习“PHP免费学习笔记(深入)”;
- 金额类:一律用
string或整数(单位“分”),避免浮点运算,例如"19.99"或1999 - 需要固定小数位展示:用
number_format($val, 2, '.', '')或sprintf('%.2f', $val),但注意这是字符串,不能再当数字计算 - JSON 输出需精确:用
JSON_PRESERVE_ZERO_FRACTION(PHP 7.1+),它会让1.0变成1.0而非1,但不解决浮点误差本身 - 数据库写入:PDO 绑定参数时用
PDO::PARAM_STR强制走字符串,或使用DECIMAL字段配合number_format入库
为什么 var_dump() 和 echo 显示不同
这是最容易混淆的一点:
-
var_dump(0.1 + 0.2)受precision控制,可能显示float(0.3)(隐藏了误差) -
echo (0.1 + 0.2) === 0.3 ? 'yes' : 'no'永远输出no,因为底层二进制表示根本不同 -
json_encode([0.1 + 0.2])同样受precision影响,但 PHP 7.4+ 默认用更保守的精度逻辑,可能比 CLI 显示更多位数 - 用
sprintf('%.17g', 0.1 + 0.2)才能看到真实存储值:0.30000000000000004
差异根源不在 CLI/Web,而在你没意识到:浮点数本就不能精确表示十进制小数,所有“看起来一样”的输出,都是精度截断后的幻觉。











