27、PHP 8.4 新特性 - BCMath 中支持对象类型

RFC：https://wiki.php.net/rfc/support_object_type_in_bcmath

在 PHP 8.4 中，BCMath 扩展 迎来了一项重要更新：支持 对象类型。这一新特性扩展了 PHP 内置的 BCMath 扩展的功能，使得开发者在处理大数运算时，能够直接处理对象类型的数值，而不再仅仅局限于原始的字符串或数字类型。这对于一些复杂的应用场景（如面向对象的编程和大数运算）非常有帮助。

背景：BCMath 扩展

BCMath（Big Integer Math）扩展是 PHP 提供的一种用于高精度数学运算的工具，特别适用于处理大于 PHP 默认整数范围的数值。BCMath 扩展提供了多个函数，可以用于执行加、减、乘、除等高精度数学运算，支持非常大的整数（比默认的 int 类型能处理的范围大得多）。

在 PHP 8.3 及之前的版本中，BCMath 扩展的函数接受的数值参数必须是 字符串类型，因为 PHP 中的 int 和 float 类型可能不能处理大于其能表示的最大值的数。因此，BCMath 函数将输入的数值作为字符串处理，以确保准确性。

PHP 8.4 中的变化：支持对象类型

PHP 8.4 引入的更新使得 BCMath 扩展不仅支持 字符串类型，还支持 对象类型。具体来说，现在可以将实现了 __toString() 方法的对象传递给 BCMath 的函数，而 BCMath 会自动将这些对象转化为字符串进行运算。这意味着，开发者可以将大数值封装在对象中，并在需要进行大数运算时，将这些对象直接传递给 BCMath 函数。

语法与用法

PHP 8.4 中，如果你想要在 BCMath 中使用对象类型，首先需要确保你的对象实现了 __toString() 方法。该方法返回一个字符串，该字符串是对象的字符串表示，BCMath 函数将基于这个字符串进行运算。

其他 BCMath 函数的支持

PHP 8.4 对于所有 BCMath 函数都支持对象类型，包括以下常见函数：

• bcadd(): 加法
• bcsub(): 减法
• bcmul(): 乘法
• bcdiv(): 除法
• bcmod(): 取模
• bcpow(): 求幂
• bcsqrt(): 开方
• bcscale(): 设置小数点精度

案例：基本使用

<?php

declare(strict_types=1);

$num1 = new \BcMath\Number('1');
$num2 = new \BcMath\Number('2');
$result = $num1->add($num2);
print_r($result);
echo $result->value;

输出

BcMath\Number Object
(
    [value] => 3
    [scale] => 0
)
3

案例：实现支持 BCMath 的对象

<?php

declare(strict_types=1);
    
class BigNumber {
    private string $value;

    public function __construct(string $value) {
        $this->value = $value;
    }

    // 实现 __toString() 方法，使对象能作为字符串使用
    public function __toString(): string {
        return $this->value;
    }
}

// 创建 BigNumber 对象
$bigNumber1 = new BigNumber("123456789123456789123456789");
$bigNumber2 = new BigNumber("987654321987654321987654321");

// 使用 BCMath 扩展进行加法运算
$result = bcadd($bigNumber1, $bigNumber2);
echo $result;

输出

1111111111111111111111111110