PHP: полный мануал с примерами, функциями и ООП

PHP 4+; nullable scale с 8.0 · bcmath

bcadd(string $num1, string $num2, ?int $scale = null): string

Сложить цены, сохранив десятичные разряды.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. foreach ($items as $item) проходит список; форма $key => $value получает также ключ. [...] создаёт массив; [$a, $b] = ... раскладывает два результата по переменным, $data["value"] читает элемент по ключу. Начало: переменная; Вызов и return.

<?php
echo bcadd('19.90', '0.10', 2), "\n";
echo bcadd('999999999999999999999', '1', 0), "\n";

20.00
1000000000000000000000

<?php
function cartSum($prices) {
    $total = '0.00';
    foreach ($prices as $price) {
        $total = bcadd($total, $price, 2);
    }
    return $total;
}
echo cartSum(['12.40', '0.60', '7.00']), "\n";

20.00

Практическая граница. При scale 2 промежуточные тысячные теряются на каждом сложении. Если они значимы, храните их до выбранного этапа округления. Большие идентификаторы не нужно складывать лишь потому, что они состоят из цифр.

Соседние инструменты: bcsub, bcround, BcMath\Number::add. Выбор по задаче.

• PHP: bcadd

PHP 4+; nullable scale с 8.0 · bcmath

bcsub(string $num1, string $num2, ?int $scale = null): string

Вычесть возврат или оплату из суммы счёта.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. if (условие) выбирает действие; === сравнивает значение и тип, !== проверяет их различие. Начало: переменная; Вызов и return.

<?php
echo bcsub('50.00', '12.35', 2), "\n";
echo bcsub('0', '0.019', 2), "\n";

37.65
-0.01

<?php
function debit($balance, $amount) {
    if (bccomp($amount, $balance, 2) === 1) {
        return 'Недостаточно средств';
    }
    return bcsub($balance, $amount, 2);
}
echo debit('25.00', '10.20'), "\n";
echo debit('25.00', '30.00'), "\n";

14.80
Недостаточно средств

Практическая граница. Порядок операндов существенен. Отрицательный результат допустим математически, но не всегда допустим для остатка товара/баланса. Правила задачи проверяются отдельно.

Соседние инструменты: bcadd, bcround, BcMath\Number::sub. Выбор по задаче.

• PHP: bcsub

PHP 4+; nullable scale с 8.0; заполнение нулями по scale с 7.3 · bcmath

bcmul(string $num1, string $num2, ?int $scale = null): string

Получить стоимость количества или сумму комиссии.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. RoundingMode::HalfEven — именованный вариант правила округления, а не строка или вызов. Начало: переменная; Вызов и return.

<?php
echo bcmul('12.35', '3', 2), "\n";
echo bcmul('4', '5', 2), "\n";

37.05
20.00

<?php
$commission = bcmul('19.99', '0.075', 5);
echo $commission, "\n";
echo bcround($commission, 2, RoundingMode::HalfAwayFromZero), "\n";

1.49925
1.50

Практическая граница. Для целых копеек int бывает проще, пока нет переполнения и дробных частей копейки. Умножение длинных строк и большой scale требуют времени и памяти: ограничивайте внешние размеры и измеряйте свой расчёт.

Соседние инструменты: bcdiv, bcround, BcMath\Number::mul. Выбор по задаче.

• PHP: bcmul

PHP 4+ · bcmath

bcdiv(string $num1, string $num2, ?int $scale = null): string

Разделить сумму на количество, не переходя к двоичному float.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. if (условие) выбирает действие; === сравнивает значение и тип, !== проверяет их различие. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. Начало: переменная; Вызов и return.

<?php
echo bcdiv('10.00', '3', 2), "\n";
echo bcdiv('-10', '3', 0), "\n";

3.33
-3

<?php
function averagePrice($total, $count) {
    if (bccomp($count, '0', 0) <= 0) {
        return 'Количество должно быть положительным';
    }
    return bcdiv($total, $count, 4);
}
echo averagePrice('25.00', '8'), "\n";
echo averagePrice('25.00', '0'), "\n";

3.1250
Количество должно быть положительным

<?php
try { bcdiv('1', '-0.00', 2); }
catch (DivisionByZeroError $error) { echo "Делитель равен нулю\n"; }

Делитель равен нулю

Практическая граница. Ограниченный scale не представляет бесконечную периодическую дробь точно. Для распределения копеек понадобятся целое частное и остаток, а не одинаковая усечённая доля.

Соседние инструменты: bcdivmod, bcmul, BcMath\Number::div. Выбор по задаче.

• PHP: bcdiv

PHP 4+; дробные операнды и scale с 7.2; nullable и DivisionByZeroError с 8.0 · bcmath

bcmod(string $num1, string $num2, ?int $scale = null): string

Найти остаток после целого количества порций, включая дробные исходные величины.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. Начало: переменная; Вызов и return.

<?php
echo bcmod('17.55', '4.2', 2), "\n";
echo bcmod('-17.55', '4.2', 2), "\n";

0.75
-0.75

<?php
function looseItems($items, $packSize) {
    return bcmod($items, $packSize, 0);
}
echo looseItems('100000000000000000005', '12'), "\n";
try { looseItems('10', '0'); }
catch (DivisionByZeroError $error) { echo "Размер упаковки не может быть нулём\n"; }

9
Размер упаковки не может быть нулём

Практическая граница. Отрицательный остаток не является автоматически номером циклической ячейки 0…m−1. Для положительного m нормализуют при необходимости bcmod(bcadd(r,m),m); это отдельное правило задачи.

Соседние инструменты: bcdivmod, bcpowmod, BcMath\Number::mod. Выбор по задаче.

• PHP: bcmod

PHP 8.4+ · bcmath

bcdivmod(string $num1, string $num2, ?int $scale = null): array

Получить целое частное и остаток одним вызовом: например, разделить 1000 копеек на три части.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. [...] создаёт массив; [$a, $b] = ... раскладывает два результата по переменным, $data["value"] читает элемент по ключу. Начало: переменная; Вызов и return.

<?php
[$share, $rest] = bcdivmod('1000', '3', 0);
echo $share, "\n", $rest, "\n";

333
1

<?php
[$share, $rest] = bcdivmod('1000', '3', 0);
$parts = [$share, $share, $share];
$parts[0] = bcadd($parts[0], $rest, 0);
echo implode(', ', $parts), "\n";
echo bcadd(bcadd($parts[0], $parts[1], 0), $parts[2], 0), "\n";

334, 333, 333
1000

<?php
[$q, $r] = bcdivmod('-17.55', '4.2', 1);
echo $q, "\n", $r, "\n";

-4
-0.7

Практическая граница. Для точного восстановления входа выбирайте достаточный scale остатка. На PHP 8.2/8.3 вызывайте bcdiv(a,b,0) и bcmod(a,b,scale) отдельно.

Соседние инструменты: bcdiv, bcmod, BcMath\Number::divmod. Выбор по задаче.

• PHP: bcdivmod

PHP 4+ · bcmath

bccomp(string $num1, string $num2, ?int $scale = null): int

Сравнить значения десятичных строк, даже если их текстовый формат различается.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. if (условие) выбирает действие; === сравнивает значение и тип, !== проверяет их различие. Начало: переменная; Вызов и return.

<?php
var_dump(bccomp('12.345', '12.349', 2));
var_dump(bccomp('12.345', '12.349', 3));
var_dump(bccomp('-0.00', '+0.000', 3));

int(0)
int(-1)
int(0)

<?php
function deliveryLabel($total) {
    if (bccomp($total, '1500.00', 2) >= 0) {
        return 'Бесплатно';
    }
    return 'По тарифу';
}
echo deliveryLabel('1499.99'), "\n";
echo deliveryLabel('1500.0'), "\n";

По тарифу
Бесплатно

Практическая граница. Строковое === сравнивает запись, а преобразование в float теряет точность. Выберите масштаб по данным; для Number::compare(null) используются все разряды.

Соседние инструменты: BcMath\Number::compare, bcscale. Выбор по задаче.

• PHP: bccomp

PHP 4+; getter и возврат старого значения с 7.3; nullable с 8.0 · bcmath

bcscale(?int $scale = null): int

Задать значение по умолчанию для процедурных вычислений или узнать текущее.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. Объект и обращение к нему. Начало: переменная; Вызов и return.

До PHP 7.3 параметр был обязательным, а setter возвращал true. bcmath.scale по умолчанию 0 и имеет режим INI_ALL.

<?php
bcscale(2);
echo bcscale(), "\n";
echo bcdiv('1', '8'), "\n";
echo bcscale(4), "\n";
echo bcdiv('1', '8'), "\n";

2
0.12
2
0.1250

<?php
bcscale(2);
function legacyReport() {
    $old = bcscale(4);
    try { return bcdiv('1', '8'); }
    finally { bcscale($old); }
}
echo legacyReport(), "\n";
echo bcscale(), "\n";
echo (new BcMath\Number('1'))->div(8), "\n";

0.1250
2
0.125

Практическая граница. Скрытая настройка усложняет библиотеки и долгоживущие workers: предпочтительны явные scale. Это не региональная точность, не количество значащих цифр и не правило округления.

Соседние инструменты: bcdiv, BcMath\Number. Выбор по задаче.

• PHP: bcscale

PHP 4+ · bcmath

bcpow(string $num, string $exponent, ?int $scale = null): string

Возвести десятичное основание в целую степень: накопление коэффициента за несколько периодов.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. Начало: переменная; Вызов и return.

<?php
echo bcpow('1.05', '2', 4), "\n";
echo bcpow('2', '0', 2), "\n";
echo bcpow('2', '-3', 3), "\n";

1.1025
1.00
0.125

<?php
function projectedTotal($initial, $factor, $periods) {
    return bcmul($initial, bcpow($factor, $periods, 6), 6);
}
echo projectedTotal('1000.00', '1.02', '3'), "\n";
try { bcpow('9', '0.5', 2); }
catch (ValueError $error) { echo "Показатель должен быть целым\n"; }

1061.208000
Показатель должен быть целым

<?php
try { bcpow('0', '-1', 2); }
catch (DivisionByZeroError $error) { echo "Обратного нулю нет\n"; }

Обратного нулю нет

Практическая граница. Размер результата быстро растёт с показателем. Для огромного показателя по модулю используйте bcpowmod, а не сначала полную степень. Оператор ^ в PHP — XOR, степень записывается **.

Соседние инструменты: bcpowmod, bcsqrt, BcMath\Number::pow. Выбор по задаче.

• PHP: bcpow

PHP 5+ · bcmath

bcpowmod(string $num, string $exponent, string $modulus, ?int $scale = null): string

Вычислить остаток большой степени, не создавая сначала всю огромную степень.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. Начало: переменная; Вызов и return.

<?php
echo bcpowmod('7', '4', '13', 0), "\n";
echo bcpowmod('-7', '3', '13', 2), "\n";

9
-5.00

<?php
echo bcpowmod('2', '1000', '97', 0), "\n";
try { bcpowmod('2', '-1', '97', 0); }
catch (ValueError $error) { echo "Отрицательный показатель запрещён\n"; }

36
Отрицательный показатель запрещён

Практическая граница. Для целых положительных входов соответствует bcmod(bcpow(...),modulus), но избегает роста полной степени. Не путайте отрицательную степень с модульным обратным: данный API её не вычисляет. С PHP 8.0 отрицательный exponent/нулевой modulus дают исключения вместо false; scale допускает null.

Соседние инструменты: bcpow, bcmod, BcMath\Number::powmod. Выбор по задаче.

• PHP: bcpowmod

PHP 4+ · bcmath

bcsqrt(string $num, ?int $scale = null): string

Получить квадратный корень для расчёта стороны или нормирования величины.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. Начало: переменная; Вызов и return.

<?php
echo bcsqrt('6.25', 2), "\n";
echo bcsqrt('3', 5), "\n";

2.50
1.73205

<?php
function squareSide($area) {
    return bcsqrt($area, 3);
}
echo squareSide('12.25'), "\n";
try { squareSide('-1'); }
catch (ValueError $error) { echo "Площадь не может быть отрицательной\n"; }

3.500
Площадь не может быть отрицательной

Практическая граница. Для округления корня до заданного разряда нужен запас вычисленных цифр и согласованная политика погрешности. С PHP 8.0 плохая строка/отрицательное число — ValueError вместо warning; отрицательный scale больше не превращается молча в 0.

Соседние инструменты: bcpow, BcMath\Number::sqrt, bcround. Выбор по задаче.

• PHP: bcsqrt

PHP 8.4+ · bcmath

bcceil(string $num): string

Округлить десятичную строку до целого в сторону +∞.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. Начало: переменная; Вызов и return.

<?php
echo bcceil('2.1'), "\n";
echo bcceil('-2.1'), "\n";

3
-2

<?php
$ratio = bcdiv('17', '4', 2);
echo bcceil($ratio), "\n";

5

Практическая граница. Не зависит от bcscale. Для двух знаков после точки используйте bcround с соответствующим RoundingMode. Не переводите результат в int без проверки диапазона.

Соседние инструменты: bcfloor, bcround, BcMath\Number::ceil. Выбор по задаче.

• PHP: bcceil

PHP 8.4+ · bcmath

bcfloor(string $num): string

Округлить десятичную строку до целого в сторону −∞.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. Начало: переменная; Вызов и return.

<?php
echo bcfloor('2.1'), "\n";
echo bcfloor('-2.1'), "\n";

2
-3

<?php
function lowerBucket($measurement) { return bcfloor($measurement); }
echo lowerBucket('3.8'), "\n";
echo lowerBucket('-0.2'), "\n";

3
-1

Практическая граница. Не зависит от bcscale. Для двух знаков после точки используйте bcround с соответствующим RoundingMode. Не переводите результат в int без проверки диапазона.

Соседние инструменты: bcceil, bcround, BcMath\Number::floor. Выбор по задаче.

• PHP: bcfloor

PHP 8.4+ · bcmath

bcround(string $num, int $precision = 0, RoundingMode $mode = RoundingMode::HalfAwayFromZero): string

Округлить точное десятичное значение по явно выбранному правилу.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. RoundingMode::HalfEven — именованный вариант правила округления, а не строка или вызов. Начало: переменная; Вызов и return.

<?php
echo bcround('12.345', 2), "\n";
echo bcround('126', -1), "\n";
echo bcround('2.5', 3), "\n";

12.35
130
2.500

<?php
echo bcround('2.345', 2, RoundingMode::HalfEven), "\n";
echo bcround('-2.345', 2, RoundingMode::HalfAwayFromZero), "\n";
try { bcround('1.5', 0, PHP_ROUND_HALF_UP); }
catch (TypeError $error) { echo "Нужен вариант RoundingMode\n"; }

2.34
-2.35
Нужен вариант RoundingMode

<?php
try { bcround('12,30', 2); }
catch (ValueError $error) { echo "Неверная запись числа\n"; }
try { bcadd('1', '2', -1); }
catch (ValueError $error) { echo "Отрицательный scale запрещён\n"; }
echo bcround('126', -1), "\n";

Неверная запись числа
Отрицательный scale запрещён
130

Практическая граница. PHP 8.4+. На 8.2/8.3 встроенного bcround нет: не превращайте строку во float ради round; применяйте проверенную decimal/money-библиотеку с нужной политикой. Очень большая precision требует памяти; ограничьте её диапазоном задачи.

Соседние инструменты: RoundingMode, bcceil, bcfloor, BcMath\Number::round. Выбор по задаче.

• PHP: bcround

PHP 8.4+ · bcmath

final readonly class BcMath\Number implements Stringable

Хранить точное десятичное значение вместе с его масштабом и получать новые числа при вычислениях.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$price = new BcMath\Number('12.30');
$total = $price->mul(3);
echo $price->value, " / ", $price->scale, "\n";
echo $total->value, " / ", $total->scale, "\n";

12.30 / 2
36.90 / 2

<?php
$price = new BcMath\Number('5.25');
$before = $price;
$total = $price * 2 + '0.50';
$price += '1.00';
echo $total, "\n", $before, "\n", $price, "\n";

11.00
5.25
6.25

<?php
$a = new BcMath\Number('2.00');
$b = new BcMath\Number('2');
var_dump($a == $b, $a === $b, $a->compare($b) === 0);
var_dump((bool) new BcMath\Number('0.00'));
try { $a->value = '3'; }
catch (Error $error) { echo "Значение нельзя переписать\n"; }

bool(true)
bool(false)
bool(true)
bool(false)
Значение нельзя переписать

Практическая граница. Поиск нуля через if($number) отличается от проверки строки "0.00". В арифметике с обычными десятичными строками без объекта PHP может выбрать float: нужен Number хотя бы с одной стороны. Для явной точности удобнее методы, а для обычного PHP 8.2/8.3 — bc-функции.

Соседние инструменты: BcMath\Number::__construct, BcMath\Number::compare, bcadd, bcscale. Выбор по задаче.

• PHP: BcMath\Number

PHP 8.4+ · bcmath

new BcMath\Number(string|int $num)

Создать проверенное десятичное число из строки или целого.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. declare(strict_types=1) включает строгую передачу скалярных аргументов в этом файле. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$amount = new BcMath\Number('+0012.300');
$count = new BcMath\Number(12);
echo $amount->value, ':', $amount->scale, "\n";
echo $count->value, ':', $count->scale, "\n";

12.300:3
12:0

<?php
declare(strict_types=1);
try { new BcMath\Number('12,30'); }
catch (ValueError $error) { echo "Нужна десятичная точка\n"; }
try { new BcMath\Number(12.3); }
catch (TypeError $error) { echo "Передайте исходную строку\n"; }

Нужна десятичная точка
Передайте исходную строку

Практическая граница. Конструктор подтверждает синтаксис BCMath, но не правила цены. Пустая строка и один знак в текущем PHP превращаются в ноль, поэтому обязательность и формат внешнего поля нужно проверять до new.

Соседние инструменты: BcMath\Number, BcMath\Number::__serialize. Выбор по задаче.

• PHP: BcMath\Number::__construct

PHP 8.4+ · bcmath

Number::add(Number|string|int $num, ?int $scale = null): Number

Сложить сумму заказа с доставкой.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$amount = new BcMath\Number('12.30');
$result = $amount->add('0.125');
echo $result, ':', $result->scale, "\n";
echo $amount, "\n";

12.425:3
12.30

<?php
function withShipping($subtotal, $shipping) {
    return $subtotal->add($shipping, 2);
}
echo withShipping(new BcMath\Number('24.50'), '3.70'), "\n";
echo (new BcMath\Number('1.999'))->add('0', 2), "\n";

28.20
1.99

Практическая граница. Не путайте уменьшение scale с округлением. Новый результат нужно сохранить; вызов $amount->add(...) сам по себе не меняет $amount.

Соседние инструменты: bcadd, BcMath\Number::sub, BcMath\Number::round. Выбор по задаче.

• PHP: BcMath\Number::add

PHP 8.4+ · bcmath

Number::sub(Number|string|int $num, ?int $scale = null): Number

Вычесть возврат, сохранив исходную сумму для журнала.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$amount = new BcMath\Number('20.00');
echo $amount->sub('3.125'), "\n";
echo $amount, "\n";

16.875
20.00

<?php
function remaining($amount, $refund) {
    return $amount->sub($refund, 2);
}
echo remaining(new BcMath\Number('15.50'), 4), "\n";
echo remaining(new BcMath\Number('1.00'), '2.00'), "\n";

11.50
-1.00

Практическая граница. Отрицательный ответ допустим API; запрет переплаты/перевозврата — отдельный инвариант приложения. Неизменяемый объект не заменяет транзакцию БД.

Соседние инструменты: bcsub, BcMath\Number::add, BcMath\Number::round. Выбор по задаче.

• PHP: BcMath\Number::sub

PHP 8.4+ · bcmath

Number::mul(Number|string|int $num, ?int $scale = null): Number

Умножить тариф на количество или коэффициент.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$tariff = new BcMath\Number('2.50');
$result = $tariff->mul('1.2');
echo $result, ':', $result->scale, "\n";

3.000:3

<?php
function lineTotal($price, $quantity) { return $price->mul($quantity, 2); }
echo lineTotal(new BcMath\Number('7.35'), 3), "\n";
echo (new BcMath\Number('19.99'))->mul('0.075')->round(2), "\n";

22.05
1.50

Практическая граница. Автоматический scale сохраняет все разряды конечного произведения, но растёт при длинной цепочке умножений. Округляйте на согласованных границах и ограничивайте число/размер входов.

Соседние инструменты: bcmul, BcMath\Number::div, BcMath\Number::round. Выбор по задаче.

• PHP: BcMath\Number::mul

PHP 8.4+ · bcmath

Number::mod(Number|string|int $num, ?int $scale = null): Number

Найти остаток длины после целого количества отрезков.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$length = new BcMath\Number('17.55');
$rest = $length->mod('4.2');
echo $rest, ':', $rest->scale, "\n";
echo $length->mod('4.2', 1), "\n";

0.75:2
0.7

<?php
echo (new BcMath\Number('-17.55'))->mod('4.2'), "\n";
try { (new BcMath\Number('8'))->mod(0); }
catch (DivisionByZeroError $error) { echo "Нулевой размер отрезка\n"; }

-0.75
Нулевой размер отрезка

Практическая граница. Ненулевой остаток имеет знак исходного числа, а не делителя. Перегруженный % для Number сохраняет десятичное поведение, в отличие от обычного % с простыми числовыми строками.

Соседние инструменты: bcmod, BcMath\Number::divmod, BcMath\Number::round. Выбор по задаче.

• PHP: BcMath\Number::mod

PHP 8.4+ · bcmath

Number::div(Number|string|int $num, ?int $scale = null): Number

Разделить число и сохранить достаточные дополнительные разряды в пределах автоматического правила.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$one = new BcMath\Number('1.00');
$third = $one->div(3);
$eighth = $one->div(8);
echo $third, ':', $third->scale, "\n";
echo $eighth, ':', $eighth->scale, "\n";

0.333333333333:12
0.125:3

<?php
$one = new BcMath\Number('1');
echo $one->div('2000000000000'), "\n";
echo $one->div('2000000000000', 13), "\n";
echo (new BcMath\Number('10.00'))->div(3, 2), "\n";

0
0.0000000000005
3.33

Практическая граница. Автоматический +10 — договор API, не универсальная гарантия требуемой погрешности. Для денег/измерений выбирайте масштаб по задаче, а для распределения всей суммы используйте divmod.

Соседние инструменты: bcdiv, BcMath\Number::divmod, BcMath\Number::sqrt. Выбор по задаче.

• PHP: BcMath\Number::div

PHP 8.4+ · bcmath

Number::divmod(Number|string|int $num, ?int $scale = null): array

Разделить количество на полные группы и получить остаток объектами Number.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. [...] создаёт массив; [$a, $b] = ... раскладывает два результата по переменным, $data["value"] читает элемент по ключу. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
[$q, $r] = (new BcMath\Number('17.55'))->divmod('4.2');
echo $q, ':', $q->scale, "\n";
echo $r, ':', $r->scale, "\n";

4:0
0.75:2

<?php
function packing($items, $size) {
    [$boxes, $loose] = $items->divmod($size);
    return 'Коробки: ' . $boxes . '; отдельно: ' . $loose;
}
echo packing(new BcMath\Number('53'), 12), "\n";
[$q, $r] = (new BcMath\Number('-17.55'))->divmod('4.2', 1);
echo $q, ' / ', $r, "\n";

Коробки: 4; отдельно: 5
-4 / -0.7

Практическая граница. Это не пара «полное десятичное частное и остаток»: частное целое. Проверьте положительность размера коробки; нулевой размер API отклоняет сам.

Соседние инструменты: bcdivmod, BcMath\Number::div, BcMath\Number::mod. Выбор по задаче.

• PHP: BcMath\Number::divmod

PHP 8.4+ · bcmath

Number::compare(Number|string|int $num, ?int $scale = null): int

Проверить числовое равенство или порядок, не привязываясь к идентичности объектов.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$a = new BcMath\Number('2.005');
var_dump($a->compare('2.009'));
var_dump($a->compare('2.009', 2));
var_dump($a->compare('2.0050') === 0);

int(-1)
int(0)
bool(true)

<?php
function fitsBudget($cost, $limit) {
    return $cost->compare($limit) <= 0;
}
var_dump(fitsBudget(new BcMath\Number('100.0001'), '100'));
var_dump(fitsBudget(new BcMath\Number('100.0000'), '100'));

bool(false)
bool(true)

Практическая граница. compare() возвращает int, а не bool. === между двумя Number сравнивает идентичность, не арифметическое равенство; == и <=> встроенный класс перегружает для чисел.

Соседние инструменты: bccomp, BcMath\Number. Выбор по задаче.

• PHP: BcMath\Number::compare

PHP 8.4+ · bcmath

Number::pow(Number|string|int $exponent, ?int $scale = null): Number

Возвести число в целую степень с автоматическим масштабом результата.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$base = new BcMath\Number('1.20');
echo $base->pow(3), "\n";
echo $base->pow(0), "\n";
echo (new BcMath\Number('2.0'))->pow(-3), "\n";

1.728000
1
0.125

<?php
$factor = new BcMath\Number('1.02');
echo $factor->pow(3)->mul('1000')->round(2), "\n";
try { $factor->pow('0.5'); }
catch (ValueError $error) { echo "Дробная степень не поддерживается\n"; }

1061.21
Дробная степень не поддерживается

Практическая граница. Проверяйте разумный предел exponent и длину входов. Формально допустимая степень может потребовать больше ресурсов, чем доступно веб-запросу.

Соседние инструменты: bcpow, BcMath\Number::powmod, BcMath\Number::sqrt. Выбор по задаче.

• PHP: BcMath\Number::pow

PHP 8.4+ · bcmath

Number::powmod(Number|string|int $exponent, Number|string|int $modulus, ?int $scale = null): Number

Вычислить модульную степень, не материализуя полную огромную степень.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$base = new BcMath\Number('7');
echo $base->powmod(4, 13), "\n";
echo $base->powmod(4, 13, 2), "\n";

9
9.00

<?php
echo (new BcMath\Number('2'))->powmod(1000, 97), "\n";
try { (new BcMath\Number('2.5'))->powmod(3, 7); }
catch (ValueError $error) { echo "Нужно целое основание\n"; }

36
Нужно целое основание

Практическая граница. Ненулевые отрицательные остатки возможны. Алгоритм не является обещанием постоянного времени исполнения и не заменяет криптографический протокол.

Соседние инструменты: bcpowmod, BcMath\Number::pow, BcMath\Number::mod. Выбор по задаче.

• PHP: BcMath\Number::powmod

PHP 8.4+ · bcmath

Number::sqrt(?int $scale = null): Number

Получить неотрицательный квадратный корень и управлять числом его разрядов.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
echo (new BcMath\Number('6.25'))->sqrt(), "\n";
echo (new BcMath\Number('3'))->sqrt(5), "\n";

2.50
1.73205

<?php
function sideFromArea($area) { return $area->sqrt(3); }
echo sideFromArea(new BcMath\Number('12.25')), "\n";
try { sideFromArea(new BcMath\Number('-1')); }
catch (ValueError $error) { echo "Нет действительной стороны\n"; }

3.500
Нет действительной стороны

Практическая граница. Количество десятичных разрядов результата не равно доказанной точности исходных измерений. Для очень маленького корня автоматического масштаба может не хватить.

Соседние инструменты: bcsqrt, BcMath\Number::pow, BcMath\Number::div. Выбор по задаче.

• PHP: BcMath\Number::sqrt

PHP 8.4+ · bcmath

Number::ceil(): Number

Получить ближайшее целое не меньше исходного.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$positive = (new BcMath\Number('2.1'))->ceil();
$negative = (new BcMath\Number('-2.1'))->ceil();
echo $positive, ':', $positive->scale, "\n";
echo $negative, ':', $negative->scale, "\n";

3:0
-2:0

<?php
$items = new BcMath\Number('17');
$needed = $items->div(4)->ceil();
echo $needed, "\n";
echo $items, "\n";

5
17

Практическая граница. Это округление до целого независимо от bcscale. Для разрядов после точки есть round с нужным RoundingMode; для точных денежных единиц не приводите произвольно большой результат к int.

Соседние инструменты: bcceil, BcMath\Number::floor, BcMath\Number::round. Выбор по задаче.

• PHP: BcMath\Number::ceil

PHP 8.4+ · bcmath

Number::floor(): Number

Получить ближайшее целое не больше исходного.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. function name($x) { ... } объявляет повторяемое действие; параметр получает вход, return отдаёт результат вызывающему коду. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$positive = (new BcMath\Number('2.1'))->floor();
$negative = (new BcMath\Number('-2.1'))->floor();
echo $positive, ':', $positive->scale, "\n";
echo $negative, ':', $negative->scale, "\n";

2:0
-3:0

<?php
function cellStart($measurement) { return $measurement->floor(); }
echo cellStart(new BcMath\Number('4.9')), "\n";
echo cellStart(new BcMath\Number('-0.1')), "\n";

4
-1

Практическая граница. Это округление до целого независимо от bcscale. Для разрядов после точки есть round с нужным RoundingMode; для точных денежных единиц не приводите произвольно большой результат к int.

Соседние инструменты: bcfloor, BcMath\Number::ceil, BcMath\Number::round. Выбор по задаче.

• PHP: BcMath\Number::floor

PHP 8.4+ · bcmath

Number::round(int $precision = 0, RoundingMode $mode = RoundingMode::HalfAwayFromZero): Number

Получить новое число, округлённое до выбранного десятичного разряда.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. RoundingMode::HalfEven — именованный вариант правила округления, а не строка или вызов. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$raw = new BcMath\Number('2.345');
echo $raw->round(2, RoundingMode::HalfEven), "\n";
echo $raw->round(2, RoundingMode::HalfAwayFromZero), "\n";
echo $raw, "\n";

2.34
2.35
2.345

<?php
$price = new BcMath\Number('126.4');
$tens = $price->round(-1);
$padded = $price->round(3);
echo $tens, ':', $tens->scale, "\n";
echo $padded, ':', $padded->scale, "\n";

130:0
126.400:3

Практическая граница. Сначала согласуйте, округляется ли строка заказа, ставка, комиссия или итог целиком. Number не выбирает этап округления. Полная таблица восьми режимов есть в начале этой главы.

Соседние инструменты: bcround, RoundingMode, BcMath\Number::ceil, BcMath\Number::floor. Выбор по задаче.

• PHP: BcMath\Number::round

PHP 8.4+ · bcmath

Number::__toString(): string

Получить исходную десятичную строку для текста или явной передачи в другой интерфейс.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. [...] создаёт массив; [$a, $b] = ... раскладывает два результата по переменным, $data["value"] читает элемент по ключу. Объект и обращение к нему. Начало: переменная; Вызов и return.

<?php
$amount = new BcMath\Number('12.300');
$text = (string) $amount;
echo $text, "\n";
var_dump($text === $amount->value);

12.300
bool(true)

<?php
$amount = new BcMath\Number('9007199254740993.20');
$payload = ['amount' => (string) $amount, 'currency' => 'RUB'];
echo json_encode($payload, JSON_THROW_ON_ERROR), "\n";

{"amount":"9007199254740993.20","currency":"RUB"}

Практическая граница. Stringable не означает, что Number будет принят строковым параметром при strict_types=1: передавайте явное (string). Приведение самого объекта к int/float не является API точного значения; форматирующие функции с float могут уничтожить разряды.

Соседние инструменты: BcMath\Number::__construct, BcMath\Number::__serialize. Выбор по задаче.

• PHP: BcMath\Number::__toString

PHP 8.4+ · bcmath

Number::__serialize(): array

Подготовить внутренние данные Number для штатного PHP serialize().

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. [...] создаёт массив; [$a, $b] = ... раскладывает два результата по переменным, $data["value"] читает элемент по ключу. Объект и обращение к нему. Начало: переменная; Вызов и return.

Магические методы и жизненный цикл объясняет вызов hook движком; здесь показан конкретный путь числового состояния.

<?php
$number = new BcMath\Number('12.300');
$state = $number->__serialize();
echo $state['value'], "\n";
echo count($state), "\n";

12.300
1

<?php
$original = new BcMath\Number('12345678901234567890.00');
$snapshot = serialize($original);
$copy = unserialize($snapshot, ['allowed_classes' => [BcMath\Number::class]]);
echo $copy, ':', $copy->scale, "\n";
var_dump($copy->compare($original) === 0, $copy === $original);

12345678901234567890.00:2
bool(true)
bool(false)

Практическая граница. Не принимайте сериализованные PHP-объекты из недоверенного запроса. allowed_classes не превращает недоверенный формат в безопасный протокол. Для обмена обычно яснее JSON с десятичной строкой и валидацией. Структура hook показана для проверенной версии, не как долгосрочная внешняя схема.

Соседние инструменты: BcMath\Number::__unserialize, BcMath\Number::__toString. Выбор по задаче.

• PHP: BcMath\Number::__serialize

PHP 8.4+ · bcmath

Number::__unserialize(array $data): void

Восстановить новый Number из состояния, созданного сериализацией.

$name — переменная; = сохраняет результат, кавычки задают строку, ; завершает команду. name(...) вызывает функцию с аргументами через запятую. echo выводит, "\n" переносит строку; var_dump показывает значение и его тип. new BcMath\Number(...) создаёт число-объект. Обратная косая черта — часть полного имени класса. $number->method(...) вызывает действие этого объекта; ->value и ->scale читают его свойства. public означает доступность извне, readonly — запрет изменения после инициализации, final — запрет наследования. try начинает попытку, catch (Тип $error) обрабатывает пойманный отказ, finally выполняет завершающие действия. throw new ... сообщает об отказе; finally его не подавляет. [...] создаёт массив; [$a, $b] = ... раскладывает два результата по переменным, $data["value"] читает элемент по ключу. Объект и обращение к нему. Начало: переменная; Вызов и return.

Расхождение подтверждено первичным исходником php-8.5.11/ext/bcmath/bcmath.c, метод __unserialize и отдельным выполнением. В другой версии тип отказа нужно сверять повторно.

<?php
$snapshot = serialize(new BcMath\Number('7.250'));
$restored = unserialize($snapshot, ['allowed_classes' => [BcMath\Number::class]]);
echo $restored->value, ':', $restored->scale, "\n";

7.250:3

<?php
$number = new BcMath\Number('7.25');
try { $number->__unserialize(['value' => 5]); }
catch (Throwable $error) { echo $error::class, "\n"; }
try { $number->__unserialize(['value' => '9.00']); }
catch (Throwable $error) { echo $error::class, "\n"; }
echo $number, "\n";

Exception
Error
7.25

Практическая граница. Не обходите readonly повторным hook. Не стройте код на предположении, что реальная ошибка обязательно ValueError: оно расходится с исследованной реализацией. Внешнюю цену принимайте строкой, проверяйте и создавайте через конструктор.

Соседние инструменты: BcMath\Number::__serialize, BcMath\Number::__construct. Выбор по задаче.

• PHP: BcMath\Number::__unserialize