A PHP 5.3+ mathematics library, providing functionality for large numbers
Switch branches/tags
Nothing to show
Clone or download
#12 Compare This branch is 40 commits ahead of moontoast:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/Moontoast/Math Substitute algorithm for setting the absolute value Mar 10, 2017
README.md Update installation instructions in README Nov 17, 2016


Moontoast Math Library

Source Code Latest Version Software License Build Status Coverage Status Total Downloads

Moontoast\Math is useful for working with integers that are larger than (or may become larger than, through mathematical computations) PHP's max integer value for a given system. On 64-bit systems, this number is 9223372036854775807. On 32-bit systems, it is 2147483647. When overflowing this boundary, PHP turns the number into a float, reducing precision (see the PHP manual entry for Integers).

Moontoast\Math provides an easy-to-use wrapper around the bcmath extension, allowing one to perform mathematical calculations on numeric strings, going well outside the integer range of the system and maintaining arbitrary precision for more precise calculations.

Moontoast\Math requires PHP 5.3+ and the bcmath extension.


The preferred method of installation is via Composer:

composer require moontoast/math


$bn = new \Moontoast\Math\BigNumber('9,223,372,036,854,775,808');


This produces the following output:

string(21) "322818021289917153280"
string(18) "118000000000000000"

You might want to use BigNumber to work with a UUID, which is an unsigned 128-bit integer. For example:

$uuid = \Moontoast\Math\BigNumber::convertToBase10('ff6f8cb0c57d11e19b210800200c9a66', 16);

This utility converts the UUID from hexadecimal (base 16) representation to a string representation of the unsigned 128-bit integer in decimal (base 10). You may now create a BigNumber object with it to perform calculations, if you wish.

$bn = new \Moontoast\Math\BigNumber($uuid);
echo $bn; // 339532337419071774305803111643925486182


Copyright © 2013-2016 Moontoast, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.