萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 浮點數運算精度陷阱與 BCMath 高精度計算完整指南

經典現象:0.58 * 100 = 57?

echo intval(0.58 * 100); // 輸出 57,非預期的 58

這不是 PHP Bug,而是 IEEE 754 雙精度浮點數 在二進位無法精確表示十進位小數的普遍問題。

底層原理:二進位表示缺失

  • 十進位 0.58 在二進位是無限循環小數:0.1001010001111010111000010100011110101110000101000111101...
  • 64 位元雙精度僅保留 52 位尾數,截斷後實際儲存值約為 0.57999999999999996
  • 乘以 100 得 57.99999999999999,intval() 截斷為 57

更多經典案例

var_dump((0.1 + 0.7) == 0.8); // bool(false)
var_dump(floor((0.1 + 0.7) * 10)); // int(7) 非 8

PHP 官方警告

「簡單的十進制分數如 0.1 或 0.7 不能在不丟失精度的情況下轉換為內部二進制格式……永遠不要相信浮點數結果精確到了最後一位,也永遠不要比較兩個浮點數是否相等。」

解決方案:BCMath 任意精度數學擴展

BCMath 函數以字串形式操作數字,支援任意精度,金融、電商、計價系統必用。

常用函數速查表

函數功能參數回傳
bcadd($left, $right, $scale)加法字串, 字串, 小數位數字串
bcsub($left, $right, $scale)減法同上字串
bcmul($left, $right, $scale)乘法同上字串
bcdiv($left, $right, $scale)除法同上字串
bcmod($left, $right, $scale)取模同上字串
bcpow($base, $exp, $scale)冪次字串, 字串, 小數位數字串
bcsqrt($num, $scale)平方根字串, 小數位數字串
bccomp($left, $right, $scale)比較字串, 字串, 小數位數-1/0/1
bcscale($scale)設定預設小數位整數void

實戰範例

// 設定全域預設小數位(選用)
bcscale(4);

$price = '199.99';
$qty   = '3';
$taxRate = '0.05';

// 總價 = (單價 * 數量) * (1 + 稅率)
$subtotal = bcmul($price, $qty, 4);           // 599.97
$tax = bcmul($subtotal, $taxRate, 4);         // 29.9985
$total = bcadd($subtotal, $tax, 2);           // 629.97 (保留 2 位)

// 比較
if (bccomp($total, '629.97', 2) === 0) {
    echo "金額核對正確";
}

// 避免浮點數比較陷阱
$a = '0.1'; $b = '0.7';
var_dump(bcadd($a, $b, 2) === '0.8'); // bool(true)

封裝工具類建議

class Money {
    private string $amount; // 以「分」為單位儲存整數,或字串保留小數
    private int $scale = 2;

    public function __construct(string $amount, int $scale = 2) {
        $this->amount = $amount;
        $this->scale = $scale;
    }

    public function add(Money $other): self {
        return new self(bcadd($this->amount, $other->amount, $this->scale), $this->scale);
    }

    public function multiply(float|string $factor): self {
        return new self(bcmul($this->amount, (string)$factor, $this->scale), $this->scale);
    }

    public function compareTo(Money $other): int {
        return bccomp($this->amount, $other->amount, $this->scale);
    }

    public function __toString(): string {
        return $this->amount;
    }
}

替代方案:GMP / 以「分」為單位整數運算

  • GMP:gmp_init() 等函數支援大整數運算,適合純整數場景(如以「分」計價)。
  • 整數分法:所有金額轉為整數分(元 * 100),運算全程整數,最後除 100 顯示。最簡單高效,但需注意溢位(PHP 整數上限 2^63-1,約 9 兆元,足夠多數場景)。

最佳實踐清單

  1. ✅ 所有涉及金額、比率、精密計算的欄位,資料庫用 DECIMAL(19,4),PHP 用 BCMath 或整數分。
  2. ✅ 禁止直接對浮點數使用 ==、===、intval()、floor()、round() 做關鍵業務判斷。
  3. ✅ 序列化/JSON 傳輸金額時,統一以字串 "199.99" 傳遞,避免 JSON 數值精度損失。
  4. ✅ 单元測試覆蓋邊界值:0.1+0.7、0.58*100、大數相乘、除不盡商。

結語

浮點數精度問題跨語言通用,理解 IEEE 754 原理並善用 BCMath/整數分法,是 PHP 開發者處理金融計算的必備基本功。

copyright © 萬盛學電腦網 all rights reserved