Decimal value object for PHP.
When working with monetary values, normal data types like int or float are not suitable for exact arithmetic. Try out the following in PHP:
var_dump(0.1 + 0.2); // float(0.3) var_dump(0.1 + 0.2 - 0.3); // float(5.5511151231258E-17)Handling them as string is a workaround, but as value object you can more easily encapsulate some of the logic.
Solutions like php-decimal require a PHP extension (would make it faster, but also more difficult for some servers to be available). For details see the wiki.
For monetary values itself one could look into brick/money or moneyphp/money.
Note: If you are looking for pre 8.1 versions, check out legacy library (https://github.com/spryker/decimal-object).
- Super strict on precision/scale. Does not lose significant digits on its own. You need to
trim()for this manually. - Speaking API (no le, gt methods).
- Basic math operations and checks supported.
- Immutability.
- Handle very large and very small numbers.
bcmathPHP extension enabled
composer require php-collective/decimal-object See Documentation for more details.
The following libraries are using the Decimal value object:
- dereuromark/cakephp-decimal as decimal type replacement for CakePHP ORM.
The original library here was written 2019 for Spryker ecommerce framework and since then battle-tested through millions of customers and orders as well as other complex calculations under the hood. This here is the freshly upgraded and independently maintained version for the PHP ecosystem as a whole.
Enjoy!