PHPackages descubraomundo/money - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. descubraomundo/money ActiveLibrary[Utility & Helpers](/categories/utility) descubraomundo/money ==================== Value Object that represents a monetary value (using a currency's smallest unit) v1.6.3(10y ago)12.7k[1 PRs](https://github.com/descubraomundo/money/pulls)BSD-3-ClausePHPPHP ^5.4|^7.0 Since Jul 21Pushed 8y ago2 watchersCompare [ Source](https://github.com/descubraomundo/money)[ Packagist](https://packagist.org/packages/descubraomundo/money)[ Docs](http://www.github.com/descubraomundo/money)[ RSS](/packages/descubraomundo-money/feed)WikiDiscussions master Synced 3w ago READMEChangelog (1)DependenciesVersions (13)Used By (0) Money ===== [](#money) [Value Object](http://martinfowler.com/bliki/ValueObject.html) that represents a [monetary value using a currency's smallest unit](http://martinfowler.com/eaaCatalog/money.html). This is a fork from [sebastianbergmann/money](https://github.com/sebastianbergmann/money) and we have implemented our packagist because the original project has been [abandoned](https://github.com/sebastianbergmann/money/pull/79). Installation ------------ [](#installation) Simply add a dependency on `descubraomundo/money` to your project's `composer.json` file if you use [Composer](http://getcomposer.org/) to manage the dependencies of your project. Here is a minimal example of a `composer.json` file that just defines a dependency on Money: ``` { "require": { "descubraomundo/money": "^1.6" } } ``` Usage Examples -------------- [](#usage-examples) #### Creating a Money object and accessing its monetary value [](#creating-a-money-object-and-accessing-its-monetary-value) ``` use SebastianBergmann\Money\Currency; use SebastianBergmann\Money\Money; // Create Money object that represents 1 EUR $m = new Money(100, new Currency('EUR')); // Access the Money object's monetary value print $m->getAmount(); // Access the Money object's monetary value converted to its base units print $m->getConvertedAmount(); ``` The code above produces the output shown below: ``` 100 1.00 ``` #### Creating a Money object from a string value [](#creating-a-money-object-from-a-string-value) ``` use SebastianBergmann\Money\Currency; use SebastianBergmann\Money\Money; // Create Money object that represents 12.34 EUR $m = Money::fromString('12.34', new Currency('EUR')) // Access the Money object's monetary value print $m->getAmount(); ``` The code above produces the output shown below: ``` 1234 ``` #### Using a Currency-specific subclass of Money [](#using-a-currency-specific-subclass-of-money) ``` use SebastianBergmann\Money\EUR; // Create Money object that represents 1 EUR $m = new EUR(100); // Access the Money object's monetary value print $m->getAmount(); ``` The code above produces the output shown below: ``` 100 ``` Please note that there is no subclass of `Money` that is specific to Turkish Lira as `TRY` is not a valid class name in PHP. #### Formatting a Money object using PHP's built-in NumberFormatter [](#formatting-a-money-object-using-phps-built-in-numberformatter) ``` use SebastianBergmann\Money\Currency; use SebastianBergmann\Money\Money; use SebastianBergmann\Money\IntlFormatter; // Create Money object that represents 1 EUR $m = new Money(100, new Currency('EUR')); // Format a Money object using PHP's built-in NumberFormatter (German locale) $f = new IntlFormatter('de_DE'); print $f->format($m); ``` The code above produces the output shown below: ``` 1,00 € ``` #### Basic arithmetic using Money objects [](#basic-arithmetic-using-money-objects) ``` use SebastianBergmann\Money\Currency; use SebastianBergmann\Money\Money; // Create two Money objects that represent 1 EUR and 2 EUR, respectively $a = new Money(100, new Currency('EUR')); $b = new Money(200, new Currency('EUR')); // Negate a Money object $c = $a->negate(); print $c->getAmount(); // Calculate the sum of two Money objects $c = $a->add($b); print $c->getAmount(); // Calculate the difference of two Money objects $c = $b->subtract($a); print $c->getAmount(); // Multiply a Money object with a factor $c = $a->multiply(2); print $c->getAmount(); ``` The code above produces the output shown below: ``` -100 300 100 200 ``` #### Comparing Money objects [](#comparing-money-objects) ``` use SebastianBergmann\Money\Currency; use SebastianBergmann\Money\Money; // Create two Money objects that represent 1 EUR and 2 EUR, respectively $a = new Money(100, new Currency('EUR')); $b = new Money(200, new Currency('EUR')); var_dump($a->lessThan($b)); var_dump($a->greaterThan($b)); var_dump($b->lessThan($a)); var_dump($b->greaterThan($a)); var_dump($a->compareTo($b)); var_dump($a->compareTo($a)); var_dump($b->compareTo($a)); ``` The code above produces the output shown below: ``` bool(true) bool(false) bool(false) bool(true) int(-1) int(0) int(1) ``` The `compareTo()` method returns an integer less than, equal to, or greater than zero if the value of one `Money` object is considered to be respectively less than, equal to, or greater than that of another `Money` object. You can use the `compareTo()` method to sort an array of `Money` objects using PHP's built-in sorting functions: ``` use SebastianBergmann\Money\Currency; use SebastianBergmann\Money\Money; $m = array( new Money(300, new Currency('EUR')), new Money(100, new Currency('EUR')), new Money(200, new Currency('EUR')) ); usort( $m, function ($a, $b) { return $a->compareTo($b); } ); foreach ($m as $_m) { print $_m->getAmount() . "\n"; } ``` The code above produces the output shown below: ``` 100 200 300 ``` #### Allocate the monetary value represented by a Money object among N targets [](#allocate-the-monetary-value-represented-by-a-money-object-among-n-targets) ``` use SebastianBergmann\Money\Currency; use SebastianBergmann\Money\Money; // Create a Money object that represents 0,99 EUR $a = new Money(99, new Currency('EUR')); foreach ($a->allocateToTargets(10) as $t) { print $t->getAmount() . "\n"; } ``` The code above produces the output shown below: ``` 10 10 10 10 10 10 10 10 10 9 ``` #### Allocate the monetary value represented by a Money object using a list of ratios [](#allocate-the-monetary-value-represented-by-a-money-object-using-a-list-of-ratios) ``` use SebastianBergmann\Money\Currency; use SebastianBergmann\Money\Money; // Create a Money object that represents 0,05 EUR $a = new Money(5, new Currency('EUR')); foreach ($a->allocateByRatios(array(3, 7)) as $t) { print $t->getAmount() . "\n"; } ``` The code above produces the output shown below: ``` 2 3 ``` #### Extract a percentage (and a subtotal) from the monetary value represented by a Money object [](#extract-a-percentage-and-a-subtotal-from-the-monetary-value-represented-by-a-money-object) ``` use SebastianBergmann\Money\Currency; use SebastianBergmann\Money\Money; // Create a Money object that represents 100,00 EUR $original = new Money(10000, new Currency('EUR')); // Extract 21% (and the corresponding subtotal) $extract = $original->extractPercentage(21); printf( "%d = %d + %d\n", $original->getAmount(), $extract['subtotal']->getAmount(), $extract['percentage']->getAmount() ); ``` The code above produces the output shown below: ``` 10000 = 8265 + 1735 ``` Please note that this extracts the percentage out of a monetary value where the percentage is already included. If you want to get the percentage of the monetary value you should use multiplication (`multiply(0.21)`, for instance, to calculate 21% of a monetary value represented by a Money object) instead. ### Health Score 32 — LowBetter than 69% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity18 Limited adoption so far Community16 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 92% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~92 days Recently: every ~110 days Total 12 Last Release 3703d ago PHP version history (4 changes)v1.0.0PHP >=5.3.3 v1.6.0PHP ~5.4 v1.6.1PHP >=5.4 v1.6.2PHP ^5.4|^7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/3d0a2a9c76a119d1fc79a79ba5a3eaabf1292ae867e0fd1043bd3945309c2c09?d=identicon)[descubraomundo](/maintainers/descubraomundo) --- Top Contributors [![sebastianbergmann](https://avatars.githubusercontent.com/u/25218?v=4)](https://github.com/sebastianbergmann "sebastianbergmann (172 commits)")[![browner12](https://avatars.githubusercontent.com/u/5232313?v=4)](https://github.com/browner12 "browner12 (4 commits)")[![hkdobrev](https://avatars.githubusercontent.com/u/506129?v=4)](https://github.com/hkdobrev "hkdobrev (2 commits)")[![camspiers](https://avatars.githubusercontent.com/u/51294?v=4)](https://github.com/camspiers "camspiers (2 commits)")[![ruudk](https://avatars.githubusercontent.com/u/104180?v=4)](https://github.com/ruudk "ruudk (2 commits)")[![henriquemoody](https://avatars.githubusercontent.com/u/154023?v=4)](https://github.com/henriquemoody "henriquemoody (1 commits)")[![gpassarelli](https://avatars.githubusercontent.com/u/1556169?v=4)](https://github.com/gpassarelli "gpassarelli (1 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (1 commits)")[![boris-glumpler](https://avatars.githubusercontent.com/u/580004?v=4)](https://github.com/boris-glumpler "boris-glumpler (1 commits)")[![koenpunt](https://avatars.githubusercontent.com/u/351038?v=4)](https://github.com/koenpunt "koenpunt (1 commits)") --- Tags money ### Embed Badge ![Health badge](/badges/descubraomundo-money/health.svg) ``` [![Health](https://phpackages.com/badges/descubraomundo-money/health.svg)](https://phpackages.com/packages/descubraomundo-money) ``` ### Alternatives [moneyphp/money PHP implementation of Fowler's Money pattern 4.8k88.3M493](/packages/moneyphp-money)[brick/money Money and currency library 1.9k40.4M142](/packages/brick-money)[florianv/swap PHP currency conversion library for retrieving exchange rates from 30 providers, with caching and fallback. 1.3k6.7M22](/packages/florianv-swap)[cknow/laravel-money Laravel Money 1.0k4.6M29](/packages/cknow-laravel-money)[akaunting/laravel-money Currency formatting and conversion package for Laravel 7855.7M46](/packages/akaunting-laravel-money)[kwn/number-to-words Multi language standalone PHP number to words converter. Fully tested, open for extensions and new languages. 4285.3M23](/packages/kwn-number-to-words) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)