浮點數精度問題是所有程式語言的通病 (IEEE 754 標準)。PHP 提供多種取整函數,但直接比較、顯示、轉字串皆存在陷阱。本文系統分析原因並提供生產級解決方案。
| 函數 | 行為 | 回傳型別 | 範例 |
|---|---|---|---|
| ceil() | 進一法 (向上取整) | float | ceil(4.3)=5, ceil(-4.3)=-4 |
| floor() | 捨去法 (向下取整) | float | floor(4.9)=4, floor(-4.9)=-5 |
| round() | 四捨五入 (可指定精度) | float | round(3.5)=4, round(1.955,2)=1.96 |
| intval() | 截斷小數 (向零取整) | int | intval(4.9)=4, intval(-4.9)=-4 |
// round 精度參數
round(1241757, -3); // 1242000 (百位四捨五入)
round(5.045, 2); // 5.05
round(5.055, 2); // 5.06 (銀行家圓整: 偶數進位)
ini_set('precision', 15);
echo $a; // 顯示更多位數,但內部儲存值未變
// 0.58 的二進制近似值 (52 位尾數)
0.58 ≈ 0.57999999999999996
0.58 * 100 ≈ 57.99999999999999
intval(57.9999...) = 57
同理:0.1 + 0.2 !== 0.3 (結果 0.30000000000000004)。
$sum = 12300.00;
$a = 10000.30; $b = 2000.30; $c = 299.40;
$s = $a + $b + $c; // 12300.000000000002
var_dump($sum == $s); // bool(false)
// bccomp($left, $right, $scale) 返回 -1/0/1
bccomp($sum, $s, 2); // 0 (相等)
// 完整比較函數
function floatEquals(float $a, float $b, int $scale = 2): bool {
return bccomp((string)$a, (string)$b, $scale) === 0;
}
function floatEqualsEpsilon(float $a, float $b, float $epsilon = 0.00001): bool {
return abs($a - $b) < $epsilon;
}
// 所有金額以「分」為單位存儲為整數
$sum = 1230000; // 12300.00 元
$a = 1000030; $b = 200030; $c = 29940;
$s = $a + $b + $c; // 1230000
var_dump($sum === $s); // bool(true)
$data = ['price' => 19.99];
echo json_encode($data); // {"price":19.99} (PHP 7.1+ 預設 JSON_PRESERVE_ZERO_FRACTION)
// 強制保留小數位
echo json_encode($data, JSON_PRESERVE_ZERO_FRACTION);
bccomp() (金融) 或容差比較 (科學計算)。sprintf('%.2f', $val) 或 number_format()。DECIMAL(10,2),禁止 FLOAT/DOUBLE。JSON_PRESERVE_ZERO_FRACTION。