spryker/decimal-object

PHP decimal handling as value object

1.0.0 2019-11-25 09:43 UTC

This package is auto-updated.

Last update: 2020-09-21 21:58:31 UTC


README

Build Status License Minimum PHP Version

Decimal value object for PHP.

Background

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.

Alternatives

Solutions like https://php-decimal.io require a PHP extension (would make it faster, but also more difficult for some servers to be available). For details see the wiki.

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.

Note: This library is a sandbox/showcase and for testing right now only. Alpha-version. Use with Caution.

Installation

Requirements

  • bcmath PHP extension enabled

Composer (preferred)

composer require spryker/decimal-object

Usage

See Documentation for more details.

Implementations

The following libraries are using the Decimal value object: