moneyphp/money

PHP implementation of Fowler's Money pattern

Thursday, July 19, 2018
by mark.sagikazar
Repository
100 Watchers
1995 Stars
1,342,567 Installations

PHP
105 Dependents
7 Suggesters
230 Forks
12 Open issues
34 Versions
19 % Grown

The README.md

Money

GitHub Workflow Status , _(*1)

, _(*2)

, _(*3)

PHP library to make working with money safer, easier, and fun!, _(*4)

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

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., _(*6)

<?php

use Money\Money;

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

list($part1, $part2, $part3) = $tenEur->allocate([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://moneyphp.org, _(*7)

Requirements

This library requires the BCMath PHP extension. There might be additional dependencies for specific feature, e.g. the Swap exchange implementation, check the documentation for more information., _(*8)

Version 4 requires PHP 8.0. For older version of PHP, use version 3 of this library. From version 4.5 this package will only support PHP versions that actually receive updates by PHP itself. If you want to use the package with older PHP versions, you can of course use older versions of this package., _(*9)

Install

Via Composer, _(*10)

$ composer require moneyphp/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)

Documentation

Please see the official documentation., _(*11)

Testing

We try to follow TDD by using phpunit to test this library., _(*12)

$ composer test

Running the tests in Docker

Money requires a set of dependencies, so you might want to run it in Docker., _(*13)

First, build the image locally:, _(*14)

$ docker build -t moneyphp .

Then run the tests:, _(*15)

$ docker run --rm -it -v $PWD:/app -w /app moneyphp vendor/bin/phpunit --exclude-group segmentation

Contributing

We would love to see you helping us to make this library better and better. Please keep in mind we do not use suffixes and prefixes in class names, so not CurrenciesInterface, but Currencies. Other than that, Style CI will help you using the same code style as we are using. Please provide tests when creating a PR and clear descriptions of bugs when filing issues., _(*16)

Security

If you discover any security related issues, please contact us at team@moneyphp.org., _(*17)

License

The MIT License (MIT). Please see License File for more information., _(*18)

Acknowledgements

This library is heavily inspired by Martin Fowler's Money pattern. A special remark goes to Mathias Verraes, without his contributions, in code and via his blog, this library would not be where it stands now., _(*19)

The Versions

19/07 2018

dev-master

9999999-dev http://moneyphp.org

PHP implementation of Fowler's Money pattern

library money

PHP implementation of Fowler's Money pattern

moneyphp/money

The README.md

Money

Requirements

Install

Features

Documentation

Testing

Running the tests in Docker

Contributing

Security

License

Acknowledgements

The Versions

dev-master

The Requires

The Development Requires

by Márk Sági-Kazár

by Mathias Verraes

by Frederik Bosch

dev-aggregate

The Requires

The Development Requires

by Márk Sági-Kazár

by Mathias Verraes

by Frederik Bosch

dev-denormalize

The Requires

The Development Requires

by Márk Sági-Kazár

by Mathias Verraes

by Frederik Bosch

dev-calculator_registry

The Requires

The Development Requires

by Márk Sági-Kazár

by Mathias Verraes

by Frederik Bosch

v3.1.3

The Requires

The Development Requires

by Márk Sági-Kazár

by Mathias Verraes

by Frederik Bosch

v3.1.2

The Requires

The Development Requires

by Márk Sági-Kazár

by Mathias Verraes

by Frederik Bosch

dev-locale_comma

The Requires

The Development Requires

by Márk Sági-Kazár

by Mathias Verraes

by Frederik Bosch

v3.1.1

The Requires

The Development Requires

by Márk Sági-Kazár

by Mathias Verraes

by Frederik Bosch

v3.1.0

The Requires

The Development Requires

by Márk Sági-Kazár

by Mathias Verraes

by Frederik Bosch

dev-gmp_mulitply

The Requires

The Development Requires

by Márk Sági-Kazár

by Mathias Verraes

by Frederik Bosch

dev-bitcoin_conversion

The Requires

The Development Requires

by Márk Sági-Kazár