stevenscg / money

PHP implementation of Fowler's Money pattern.

Money

PHP 5.5+ library to make working with money safer, easier, and fun!

"If I had a dime for every time I've seen someone use FLOAT to store currency, I'd have $999.997634" -- Bill Karwin

In short: You shouldn't represent monetary values by a float. Wherever you need to represent money, use this Money value object. Since version 3.0 this library uses strings internally in order to support unlimited integers.

<?php

use Money\Money;

$fiveEur = Money::EUR(500);
$tenEur = $fiveEur->add($fiveEur);

list($part1, $part2, $part3) = $tenEur->allocate(array(1, 1, 1));
assert($part1->equals(Money::EUR(334)));
assert($part2->equals(Money::EUR(333)));
assert($part3->equals(Money::EUR(333)));

The documentation is available at http://money.readthedocs.org

Installation

Install the library using composer.

composer require mathiasverraes/money

Features

• JSON Serialization
• Big integer support utilizing different, transparent calculation logic upon availability (bcmath, gmp, plain php)
• Money formatting (including intl formatter)
• Currency repositories (ISO currencies included)
• Money exchange (including Swap implementation)

Integration

See MoneyBundle or TbbcMoneyBundle for Symfony integration.