PHP 浮點數高精度計算：BCMath 擴展完整函數速查與避坑指南

PHP 浮點數存在精度缺失（0.1 + 0.7 = 0.799999...），財務、科學計算必須用 BCMath 任意精度數學擴展。本文整理全函數表、參數詳解、實戰代碼模式與常見陷阱。

BCMath 核心特性

• 數字以字符串形式表示（0-9 + 可選負號 + 小數點），無長度限制。
• 所有函數接受 $scale 參數控制結果小數位，全局預設由 bcscale() 設定。
• 返回值同為字符串，直接可用於下一步計算或存儲。

完整函數速查表

實戰代碼模式

<?php
// 1. 初始化全局精度（如財務 4 位小數）
bcscale(4);

// 2. 封裝工具類（建議）
class BCMathCalc {
    public static function add(string $a, string $b, int $scale = null): string {
        return bcadd($a, $b, $scale ?? 4);
    }
    public static function sub(string $a, string $b, int $scale = null): string {
        return bcsub($a, $b, $scale ?? 4);
    }
    // ... 其他運算
    public static function cmp(string $a, string $b, int $scale = null): int {
        return bccomp($a, $b, $scale ?? 4);
    }
}

// 3. 使用示例：連續扣款
$balance = '134.7';
$balance = BCMathCalc::sub($balance, '52.5'); // 82.2
$balance = BCMathCalc::sub($balance, '82.2'); // 0.0
echo $balance; // "0.0000"

// 4. 比較判斷
if (BCMathCalc::cmp($balance, '0') === 0) {
    echo "餘額歸零";
}

避坑指南

BCMath vs GMP 選型

• BCMath：字符串介面、語法簡單、內建常見、適合財務/商業邏輯。
• GMP：資源型別 (GMP object)、函數名 gmp_*、支援位運算、質數測試、隨機數、效能略優、適合密碼學/數論。
• PHP 8.0+ GMP 返回物件可直接運算子 (+ * 等)，BCMath 仍需函數調用。

安裝檢查

<?php
if (!extension_loaded('bcmath')) {
    die('BCMath extension required. Install: apt/php-yum install php-bcmath');
}
echo "BCMath OK\n";

牢記「字符串進、字符串出、scale 必傳」，BCMath 即可成為 PHP 高精度計算的穩固基石。