PHP 浮點數遵循 IEEE 754 雙精度標準,precision 設定僅影響顯示輸出,不影響內部儲存與運算。本文深度解析 precision 行為、經典 0.58×100=57 陷阱、運算精度保持、科學記號切換邏輯與金融級解決方案。
; php.ini
precision = 14 ; 預設 14 位有效數字 (含整數部分)
; 運行時修改
ini_set('precision', '15');
規則:整數部分位數 + 小數部分有效位數 ≤ precision。超過時四捨五入截斷。整數部分為 0 不計位數,小數尾端 0 不計位數。
$num = 12.123456; // 整數 2 位 + 小數 6 位 = 8 位
ini_set('precision', '12');
echo $num; // 12.123456 (8 < 12)
ini_set('precision', '3');
echo $num; // 12.1 (整數佔 2 位,僅剩 1 位給小數)
ini_set('precision', '5');
echo $num; // 12.123 (整數 2 位,小數 3 位)
$num = 12345678.123456; // 整數 8 位
ini_set('precision', '12');
echo $num; // 12345678.1235 (四捨五入至 12 位)
ini_set('precision', '3');
echo $num; // 1.23E+7 (整數位數 8 > precision 3,啟用科學記號)
ini_set('precision', '5');
echo $num; // 12346000 (整數位數 8 > precision 5,但差值 3 ≤ 4,補零不科學記號)
科學記號觸發條件:整數部分位數 - precision > 4 時使用科學記號,否則以 0 補齊整數位。
關鍵結論:precision **只影響輸出格式化**,內部運算始終使用完整雙精度值 (約 15-17 位十進制有效數字)。
// 0.58 無法用有限二進制精確表示
// 實際儲存值 ≈ 0.57999999999999996
// 0.58 * 100 ≈ 57.99999999999999
// intval() 截斷 → 57
intval(round($f * 100, 2)) → 58bcmul('0.58', '100', 2) → '58.00'
$sum = 12300.00;
$s = 10000.30 + 2000.30 + 299.40; // 12300.000000000002
var_dump($sum == $s); // false
bccomp($sum, $s, 2); // 0 (相等)
// 封裝函數
function floatEq(string|float $a, string|float $b, int $scale = 2): bool {
return bccomp((string)$a, (string)$b, $scale) === 0;
}
function floatEqEpsilon(float $a, float $b, float $eps = 1e-10): bool {
return abs($a - $b) < $eps;
}
// 所有金額以「分」為單位存整數
$sum = 1230000; // 12300.00
$a = 1000030; $b = 200030; $c = 29940;
$s = $a + $b + $c; // 1230000
var_dump($sum === $s); // true
$data = ['price' => 19.99, 'rate' => 0.123456789];
// PHP 7.1+ JSON_PRESERVE_ZERO_FRACTION 保留 .0
json_encode($data);
// {"price":19.99,"rate":0.123456789} (受 precision 影響可能截斷)
// 精確控制:先格式化字串
$data['price'] = sprintf('%.2f', $data['price']);
$data['rate'] = sprintf('%.8f', $data['rate']);
json_encode($data); // 精確輸出
| 場景 | 推薦做法 | 避免 |
|---|---|---|
| 金額儲存 | 資料庫 DECIMAL(19,4) / 整數分 | FLOAT, DOUBLE |
| 金額運算 | BCMath (bcmul, bcadd, bccomp) / 整數運算 | 直接 + - * / |
| 金額比較 | bccomp($a, $b, $scale) === 0 | ==, ===, <, > |
| 顯示輸出 | sprintf('%.2f', $val) / number_format() | 直接 echo $val |
| 科學計算 | 容差比較 / GMP / 專用庫 | 直接比較 |
| 序列化 | 手動 sprintf 格式化後 json_encode | 直接 json_encode 浮點數 |