Download the PHP package madebybob/php-number without Composer

PHP Number - Deal with numbers the right way

This library aims to deal with numbers like prices, weights and quantities the right way in PHP.

The problem

Have you ever worked with prices, weights, or any other numbers in PHP? What type are they? An integer? A string? Or did you get a float to manage decimals? And how can you do calculations with them? We have all struggled with float's counter-intuitive behavior.

Ahh, after hours of investigation you've found BC Math. Now you can do math with your numbers. However, it is still hard to manage those numbers in your codebase. BC Math only accepts and returns strings. Type hinting strings when working with numbers as a modern-php-techie is not done.

The solution

This library will help you to manage number in your codebase. Using the Number class you can typehint them (getTotal(Number $quantity)) and make calculations on the number itself ($number->sum('200')'). Since those methods are immutable you can chain your methods on them.

Scope

This library aims to make your code cleaner. You can typehint the Number class, and you can make cleaner calculations (still using BC Math in the background).

We have chosen not to support specific implementations of numbers like money and weights. This is too specific and out of scope. Mainly, custom implementations of numbers are business specific. In our opinion you should create them yourself, according to the desired needs of your business.

Table of Contents

• Installation
• Usage
  • Add
  • Subtract
  • Divide
  • Multiply
  • Modulus
  • State & Comparison
  • Absolute & opposite values
  • Limiting values
  • Rounding
  • Immutable & Chaining
  • Extensibility
• Testing
• Changelog
• Contributing
• Credits
• License

Installation

You can install the package via composer:

Usage

In short, the Number\Number class is where it's all about. This is how you can create a Number instance:

Creating new numbers (or using them in the methods below) supports types like Number, string, integer and float.

Add

To add a new number to your current number instance:

Subtract

To subtract a number from your current number instance:

Divide

To divide your current number instance into the given number:

Division by zero is not possible, of course. To not break your chain, a fallback value can be used like this:

Multiply

To multiply your current number instance with the given number:

Modulus

To get the modulus of the current number instance:

Square root

To get the square root of the current number instance:

State & Comparison

To compare two numbers with each other, these helpers are available, which will return a bool:

Absolute & opposite values

To get the absolute (positive) value of the current instance:

To get the opposite value of the current instance:

Limiting values

To make sure the current number is not higher or lower than expected:

To use a min and max 'clamp' at the same time:

Rounding

To round the current number instance, the following methods are available:

Immutable & Chaining

Since the Number class is immutable, most methods will return a new Number instance.

Because the mathematical methods are fluent, you will be able to chain your calculations like so:

Extensibility

We encourage you to create custom implementations of the AbstractNumber class for your specific use cases. This enables you to type hint much better which type of number you expect and how they should be formatted.

PHP Number - Examples is a repository dedicated to showing how a custom number type like weights should be implemented. Please check out this repository for further documentation about the extensibility of this package.

Testing & Php CS Fixer

`

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Supporters

Credits

• Bob Mulder
• Jon Mulder
• All Contributors

License

The MIT License (MIT). Please see License File for more information.