php 8.4 的 bcmath\number 类没有提供名为 mod 的方法。要计算取模运算，需要调用 bcmod() 函数并将 bcmath\number 对象作为参数传入，或者使用 ->tostring() 转换后处理。该类的实例本身不包含直接执行取模操作的成员方法，必须依赖外部函数或手动实现逻辑。
BcMath\Number 实例如何参与取模运算
在 PHP 8.4 中，BcMath\Number 是 BC Math 扩展引入的新面向对象封装，旨在替代传统的字符串操作方式。虽然它提供了丰富的算术方法如 add()、sub()、mul() 和 div()，但并未包含 mod() 方法。开发者若需对 BcMath\Number 对象进行取模运算，应直接使用全局函数 bcmod()。该函数接受两个参数：被除数和除数，两者均可传入 BcMath\Number 对象，因为 PHP 会自动将其转换为字符串进行处理。这种方式既保留了类型安全，又利用了 BC Math 的高精度特性。
$num = new BcMath\Number('100');
$mod = new BcMath\Number('7');
$result = bcmod($num, $mod);
// $result 为 string '2'
上述代码展示了如何将 BcMath\Number 对象传递给 bcmod()。输入的两个对象分别代表被除数 100 和除数 7，输出结果为字符串 '2'。这是目前最标准且推荐的做法，无需额外转换或自定义方法。注意 bcmod() 返回的是字符串类型，而非 BcMath\Number 对象，因此后续若需继续链式调用其他面向对象方法，需重新包装为 BcMath\Number 实例。
立即学习“PHP免费学习笔记（深入）”；
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
为何 BcMath\Number 未内置 mod() 方法
BcMath\Number 的设计哲学侧重于核心算术运算的封装，而取模运算在数学上可视为除法与乘法的组合，即 a mod b = a - (a div b) * b。因此，即使没有直接的 mod() 方法，也可通过现有方法组合实现。然而，由于 bcmod() 作为底层 C 扩展函数，性能更高且更稳定，官方选择保留其独立地位，而非将其封装进类中。这种设计避免了方法冗余，同时保持了 API 的简洁性。对于大多数场景，直接使用 bcmod() 是更高效的选择。
$num = new BcMath\Number('100');
$mod = new BcMath\Number('7');
$quotient = $num->div($mod, 0); // 整数除法
$product = $quotient->mul($mod);
$difference = $num->sub($product);
$result = $difference->toString();
// $result 为 string '2'
此代码演示了如何通过 BcMath\Number 的内置方法模拟取模运算。首先调用 div() 获取整数商，再用 mul() 乘以除数，最后用 sub() 求差。虽然步骤较多，但完全基于面向对象接口，适合需要严格类型一致性的场景。对比 bcmod()，该方法返回 BcMath\Number 对象，便于链式调用，但性能略低。开发者可根据实际需求选择合适的方式。
当除数为零时 bcmod() 的行为是什么
在使用 bcmod() 对 BcMath\Number 对象进行取模运算时，若除数为零，将触发 BcMath\DivisionByZeroError 异常。这是 BC Math 扩展的标准行为，旨在防止非法数学操作。例如，当传入的第二个参数为 BcMath\Number('0') 时，函数会立即抛出异常，不会返回任何结果。开发者应在调用前检查除数是否为零，或使用 try-catch 块捕获异常以确保程序健壮性。这一行为与传统字符串形式的 bcmod() 调用一致，确保了 API 的一致性。
