money

PHP implementation of Fowler's Money pattern.

Github stars Tracking Chart

Money

Latest Version
GitHub Workflow Status
Total Downloads

Email

Money PHP

PHP 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://moneyphp.org

Requirements

PHP 5.6+. Other than that, this library has no external requirements. MoneyPHP will not provide any support to
PHP versions that are not supported by the language itself. There might be
additional dependencies for specific feature, e.g. the Swap exchange implementation, check the documentation for more information.

Install

Via Composer

$ 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.

Testing

We try to follow BDD and TDD, as such we use both phpspec and phpunit to test this library.

$ composer test

Running the tests in Docker

Money requires a set of dependencies, so you might want to run it in Docker.

First, build the image locally:

$ docker build -t moneyphp .

Then run the tests:

$ 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.

Security

If you discover any security related issues, please contact us at team@moneyphp.org.

License

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

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.

Overview

Name With Ownermoneyphp/money
Primary LanguagePHP
Program languagePHP (Language Count: 3)
Platform
License:MIT License
Release Count43
Last Release Namev4.5.0 (Posted on )
First Release Name1.0.0 (Posted on )
Created At2011-03-29 22:58:09
Pushed At2024-02-15 19:48:30
Last Commit At2024-02-15 20:47:21
Stargazers Count4.5k
Watchers Count90
Fork Count434
Commits Count870
Has Issues Enabled
Issues Count330
Issue Open Count3
Pull Requests Count285
Pull Requests Open Count3
Pull Requests Close Count167
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private
To the top