php-collective/decimal-object

PHP decimal handling as value object

Maintainers

Details

github.com/php-collective/decimal-object

Source

Issues

Installs: 19 003

Dependents: 1

Suggesters: 0

Security: 0

Stars: 20

Watchers: 1

Forks: 4

Open Issues: 1

1.2.1 2023-12-07 13:56 UTC

Requires

Requires (Dev)

MIT 45892c18fd8ef158741c8ac32ab4118a48dc8b5e

This package is auto-updated.

Last update: 2024-12-16 22:25:52 UTC

README

CI codecov Latest Stable Version Minimum PHP Version PHPStan License

Decimal value object for PHP.

Background

When working with decimal (e.g. 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 strings is a workaround, but as value object you can more easily encapsulate some of the logic.

Alternatives

Solutions like php-decimal require a custom PHP extension (would make it faster, but also more difficult for some servers to be available). Monetary values themselves could be handled also with brick/money or moneyphp/money.

For details see the wiki.

Note: If you are looking for pre PHP 8.1 versions, check out the legacy library.

Features

  • 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.

Installation

Requirements

  • bcmath PHP extension enabled

Composer (preferred)

composer require php-collective/decimal-object

Usage

See Documentation for more details.

Implementations

The following libraries are using the Decimal value object:

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!