Money

https://github.com/moneyphp/money
Admin
Money is a PHP library that safely represents monetary values using a value object pattern,...
Tokens:34,168
Snippets:296
Trust Score:7.7
License:MIT
Update:3 weeks ago
Show doc for...
Tokens:
Raw
### Install Swap via Composer

Source: https://github.com/moneyphp/money/blob/master/doc/features/currency-conversion.rst

Composer command to install the Swap currency exchange library.

```bash
$ composer require florianv/swap
```

--------------------------------

### Install moneyphp/money via Composer

Source: https://github.com/moneyphp/money/blob/master/doc/getting-started.rst

Install the library using Composer by running this command in your command line.

```bash
$ composer require moneyphp/money
```

--------------------------------

### Install Exchanger via Composer

Source: https://github.com/moneyphp/money/blob/master/doc/features/currency-conversion.rst

Composer command to install the Exchanger currency exchange framework.

```bash
$ composer require florianv/exchanger
```

--------------------------------

### Basic Money usage with allocation

Source: https://github.com/moneyphp/money/blob/master/README.md

Shows how to create a Money object, add amounts, and allocate the total into parts. Uses the Money::EUR() factory and the allocate() method. The example asserts the allocated amounts.

```php
<?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)));
```

--------------------------------

### Allocate by Ratios with Money::allocate()

Source: https://github.com/moneyphp/money/blob/master/doc/features/allocation.rst

Allocates a Money amount according to given ratios, rounding down and distributing the remainder to the targets with the largest fractional losses. The order of ratios affects the result, as shown by the two examples.

```php
use Money\Money;

$profit = Money::EUR(5);
list($my_cut, $investors_cut) = $profit->allocate([70, 30]);
// $my_cut is 4 cents, $investors_cut is 1 cent

// The order is important:
list($investors_cut, $my_cut) = $profit->allocate([30, 70]);
// $my_cut is 3 cents, $investors_cut is 2 cents
```

--------------------------------

### Allocate to N Targets with Money::allocateTo()

Source: https://github.com/moneyphp/money/blob/master/doc/features/allocation.rst

Allocates an amount equally to N targets, distributing the remainder to the first targets. The example allocates €8.00 to 3 targets, resulting in [€2.67, €2.67, €2.66].

```php
$value = Money::EUR(800);           // €8.00

$result = $value->allocateTo(3);    // $result = [€2.67, €2.67, €2.66]
```

--------------------------------

### Money::sum() - Calculate sum of Money objects

Source: https://github.com/moneyphp/money/blob/master/doc/features/aggregation.rst

Provides the sum of all given Money objects. In the example, the sum is €2.00.

```php
$first = Money::EUR(100);                  // €1.00
$second = Money::EUR(-200);                // -€2.00
$third = Money::EUR(300);                  // €3.00

$sum = Money::sum($first, $second, $third) // €2.00
```

--------------------------------

### Money::min() - Find smallest Money object

Source: https://github.com/moneyphp/money/blob/master/doc/features/aggregation.rst

Returns the smallest of the given Money objects. In the example, the minimum is €1.00.

```php
$first = Money::EUR(100);                  // €1.00
$second = Money::EUR(200);                 // €2.00
$third = Money::EUR(300);                  // €3.00

$min = Money::min($first, $second, $third) // €1.00
```

--------------------------------

### Immutability of Money objects

Source: https://github.com/moneyphp/money/blob/master/doc/concept.rst

These examples illustrate the immutability of Money objects. The first two blocks show that calling subtract() on a Money object does not modify the original, so both variables remain EUR 25. The third block confirms equality, and the fourth shows the correct way to perform operations by reassigning the result.

```php
use Money\Money;

$jimPrice = $hannahPrice = Money::EUR(2500);
```

```php
$coupon = Money::EUR(500);
$jimPrice->subtract($coupon);
```

```php
$jimPrice->equals($hannahPrice); // true
```

```php
$jimPrice = $jimPrice->subtract($coupon);
$jimPrice->lessThan($hannahPrice); // true
$jimPrice->equals(Money::EUR(2000)); // true
```

--------------------------------

### Money::avg() - Calculate average of Money objects

Source: https://github.com/moneyphp/money/blob/master/doc/features/aggregation.rst

Returns the average value of the given Money objects as a Money object. In the example, the average is €2.00.

```php
$first = Money::EUR(100);                  // €1.00
$second = Money::EUR(-200);                // -€2.00
$third = Money::EUR(300);                  // €3.00

$avg = Money::avg($first, $second, $third) // €2.00
```

--------------------------------

### Money::max() - Find largest Money object

Source: https://github.com/moneyphp/money/blob/master/doc/features/aggregation.rst

Returns the largest of the given Money objects. In the example, the maximum is €3.00.

```php
$first = Money::EUR(100);                  // €1.00
$second = Money::EUR(200);                 // €2.00
$third = Money::EUR(300);                  // €3.00

$max = Money::max($first, $second, $third) // €3.00
```

--------------------------------

### Creating a custom currency repository with CurrencyList

Source: https://github.com/moneyphp/money/blob/master/doc/features/currencies.rst

Creates a CurrencyList with a custom currency code and minor unit pair, then iterates and queries it. Throws an exception for invalid arrays.

```php
use Money\Currencies\CurrencyList;
use Money\Currency;

$currencies = new CurrencyList([
    'MY1' => 2,
]);

foreach ($currencies as $currency) {
    echo $currency->getCode(); // prints MY1
}

$currencies->contains(new Currency('MY1')); // returns boolean whether MY1 is available in this repository (true)
$currencies->contains(new Currency('USD')); // returns boolean whether USD is available in this repository (false)
$currencies->subunitFor(new Currency('MY1')); // returns the subunit for the currency MY1 (2)
```

--------------------------------

### Build Docker image

Source: https://github.com/moneyphp/money/blob/master/README.md

Builds the Docker image for running tests in a container. Use this before running the tests in Docker.

```bash
$ docker build -t moneyphp .
```

--------------------------------

### Create CurrencyPair with OOP Notation

Source: https://github.com/moneyphp/money/blob/master/doc/features/currency-conversion.rst

Creates a CurrencyPair object using constructor with Currency objects and a rate.

```php
use Money\Currency;
use Money\CurrencyPair;

$pair = new CurrencyPair(new Currency('EUR'), new Currency('USD'), 1.2500);
```

--------------------------------

### Run tests with Composer

Source: https://github.com/moneyphp/money/blob/master/README.md

Command to run the test suite using Composer. Requires PHPUnit.

```bash
$ composer test
```

--------------------------------

### Aggregating multiple currency repositories with AggregateCurrencies

Source: https://github.com/moneyphp/money/blob/master/doc/features/currencies.rst

Creates an AggregateCurrencies instance combining Bitcoin and ISO currencies, then iterates and queries it for both XBT and USD.

```php
use Money\Currency;
use Money\Currencies\AggregateCurrencies;
use Money\Currencies\BitcoinCurrencies;
use Money\Currencies\ISOCurrencies;

$currencies = new AggregateCurrencies([
    new BitcoinCurrencies(),
    new ISOCurrencies()
]);

foreach ($currencies as $currency) {
    echo $currency->getCode(); // prints XBT or any ISO currency code
}

$currencies->contains(new Currency('XBT')); // returns boolean whether XBT is available in this repository (true)
$currencies->contains(new Currency('USD')); // returns boolean whether USD is available in this repository (true)
$currencies->subunitFor(new Currency('XBT')); // returns the subunit for the Bitcoin (8)
```

--------------------------------

### Instantiate Money with USD 5.00

Source: https://github.com/moneyphp/money/blob/master/doc/getting-started.rst

Create a Money object representing USD 5.00 (500 cents) using either the constructor with a Currency instance or the static factory method Money::USD().

```php
use Money\Currency;
use Money\Money;

$fiver = new Money(500, new Currency('USD'));
// or shorter:
$fiver = Money::USD(500);
```

--------------------------------

### isZero(), isPositive(), isNegative() methods

Source: https://github.com/moneyphp/money/blob/master/doc/features/comparison.rst

Determines the sign of a Money object. Shows truth values for zero, positive, and negative amounts.

```php
Money::USD(100)->isZero();          // false
Money::USD(0)->isZero();            // true
Money::USD(-100)->isZero();         // false

Money::USD(100)->isPositive();      // true
Money::USD(0)->isPositive();        // false
Money::USD(-100)->isPositive();     // false

Money::USD(100)->isNegative();      // false
Money::USD(0)->isNegative();        // false
Money::USD(-100)->isNegative();     // true
```

--------------------------------

### Create CurrencyPair via SwapExchange Quote

Source: https://github.com/moneyphp/money/blob/master/doc/features/currency-conversion.rst

Uses SwapExchange to quote a currency pair from EUR to USD.

```php
use Money\Currency;
use Money\Exchange\SwapExchange;

$eur = new Currency('EUR');
$usd = new Currency('USD');

// $swap = Implementation of \Swap\SwapInterface
$exchange = new SwapExchange($swap);

$pair = $exchange->quote($eur, $usd);
```

--------------------------------

### Using Bitcoin currency with Money library

Source: https://github.com/moneyphp/money/blob/master/doc/features/bitcoin.rst

Constructs a Money object with the XBT currency, creates BitcoinCurrencies, formats a Money instance with BitcoinMoneyFormatter, and parses a Bitcoin string with BitcoinMoneyParser. The subunit is 8, and the formatter uses 2 decimal places.

```php
use Money\Currencies\BitcoinCurrencies;
use Money\Currency;
use Money\Formatter\BitcoinMoneyFormatter;
use Money\Money;
use Money\Parser\BitcoinMoneyParser;

// construct bitcoin (subunit of 8)
$money = new Money(100000000000, new Currency('XBT'));

// construct bitcoin currencies
$currencies = new BitcoinCurrencies();

// format bitcoin
$formatter = new BitcoinMoneyFormatter(2, $currencies);
echo $formatter->format($money); // prints Ƀ1000.00

// parse bitcoin
$parser = new BitcoinMoneyParser(2);
$money = $parser->parse("Ƀ1000.00", 'XBT');
echo $money->getAmount(); // outputs 100000000000
```

--------------------------------

### Fixed Exchange Conversion

Source: https://github.com/moneyphp/money/blob/master/doc/features/currency-conversion.rst

Creates a FixedExchange with a rate from EUR to USD, then converts 100 EUR to USD using the Converter.

```php
use Money\Converter;
use Money\Currency;
use Money\Currencies\ISOCurrencies;
use Money\Exchange\FixedExchange;

$exchange = new FixedExchange([
    'EUR' => [
        'USD' => '1.25'
    ]
]);

$converter = new Converter(new ISOCurrencies(), $exchange);

$eur100 = Money::EUR(100);
$usd125 = $converter->convert($eur100, new Currency('USD'));
```

--------------------------------

### Using ISOCurrencies to list and query ISO 4217 currencies

Source: https://github.com/moneyphp/money/blob/master/doc/features/currencies.rst

Creates an ISOCurrencies instance, iterates over all available ISO currencies, and checks for the presence and subunit of a specific currency like USD.

```php
use Money\Currencies\ISOCurrencies;
use Money\Currency;

$currencies = new ISOCurrencies();
foreach ($currencies as $currency) {
    echo $currency->getCode(); // prints an available currency code within the repository
}

$currencies->contains(new Currency('USD')); // returns boolean whether USD is available in this repository
$currencies->subunitFor(new Currency('USD')); // returns the subunit for the dollar (2)
```

--------------------------------

### Run tests in Docker

Source: https://github.com/moneyphp/money/blob/master/README.md

Runs the test suite inside a Docker container. Mounts the current directory and runs PHPUnit with the segmentation group excluded.

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

--------------------------------

### Swap Exchange Conversion

Source: https://github.com/moneyphp/money/blob/master/doc/features/currency-conversion.rst

Uses SwapExchange with a Swap implementation to convert EUR to USD and also demonstrates convertAndReturnWithCurrencyPair.

```php
use Money\Money;
use Money\Converter;
use Money\Currencies\ISOCurrencies;
use Money\Exchange\SwapExchange;

// $swap = Implementation of \Swap\SwapInterface
$exchange = new SwapExchange($swap);

$converter = new Converter(new ISOCurrencies(), $exchange);
$eur100 = Money::EUR(100);
$usd125 = $converter->convert($eur100, new Currency('USD'));
[$usd125, $pair] = $converter->convertAndReturnWithCurrencyPair($eur100, new Currency('USD'));
```

--------------------------------

### Add multiple Money objects with variadic add()

Source: https://github.com/moneyphp/money/blob/master/doc/features/operation.rst

Adds multiple Money objects in a single call using variadic arguments. All must be in the same currency.

```php
$value1 = Money::EUR(800);                // €8.00
$value2 = Money::EUR(500);                // €5.00
$value3 = Money::EUR(600);                // €6.00

$result = $value1->add($value2, $value3); // €19.00
```

--------------------------------

### Parse ISO Currency Pair

Source: https://github.com/moneyphp/money/blob/master/doc/features/currency-conversion.rst

Parses an ISO notation string to create a CurrencyPair.

```php
use Money\CurrencyPair;

$pair = CurrencyPair::createFromIso('EUR/USD 1.2500');
```

--------------------------------

### Convert Using CurrencyPair

Source: https://github.com/moneyphp/money/blob/master/doc/features/currency-conversion.rst

Converts an amount using a previously obtained CurrencyPair with convertAgainstCurrencyPair.

```php
use Money\Money;
use Money\Currency;
use Money\Currencies\ISOCurrencies;
use Money\Exchange\SwapExchange;

// $swap = Implementation of \Swap\SwapInterface
$exchange = new SwapExchange($swap);

$converter = new Converter(new ISOCurrencies(), $exchange);
$eur100 = Money::EUR(100);
$usd125 = $converter->convertAgainstCurrencyPair($eur100, $pair);
```

--------------------------------

### Using BitcoinCurrencies to list and query Bitcoin currency

Source: https://github.com/moneyphp/money/blob/master/doc/features/currencies.rst

Creates a BitcoinCurrencies instance, iterates over the single Bitcoin currency, and checks for the presence and subunit of XBT.

```php
use Money\Currencies\BitcoinCurrencies;
use Money\Currency;

$currencies = new BitcoinCurrencies();
foreach ($currencies as $currency) {
    echo $currency->getCode(); // prints XBT
}

$currencies->contains(new Currency('XBT')); // returns boolean whether XBT is available in this repository (true)
$currencies->contains(new Currency('USD')); // returns boolean whether USD is available in this repository (false)
$currencies->subunitFor(new Currency('XBT')); // returns the subunit for the Bitcoin (8)
```

--------------------------------

### Accepted integer values for Money constructor

Source: https://github.com/moneyphp/money/blob/master/doc/getting-started.rst

Shows which integer(ish) values are accepted by the Money constructor. Passing a non-supported value (e.g., '00500' or '000') throws a \InvalidArgumentException.

```php
use Money\Currency;
use Money\Money;

// int is accepted
$fiver = new Money(500, new Currency('USD'));

// string is accepted if integer
$fiver = new Money('500', new Currency('USD'));

// string is accepted if fractional part is zero
$fiver = new Money('500.00', new Currency('USD'));

// leading zero's are not accepted
$fiver = new Money('00500', new Currency('USD'));

// multiple zero's are not accepted
$fiver = new Money('000', new Currency('USD'));
```

--------------------------------

### compare() method

Source: https://github.com/moneyphp/money/blob/master/doc/features/comparison.rst

Returns -1, 0, or 1 for less than, equal, or greater than. Throws InvalidArgumentException if currencies differ.

```php
$value1 = Money::USD(200);                  // $2.00
$value2 = Money::USD(400);                  // $4.00
$value3 = Money::USD(400);                  // $4.00

$result = $value1->compare($value2);        // -1, less than
$result = $value2->compare($value3);        // 0, equals to
$result = $value2->compare($value1);        // 1, more than

// Both Money objects must have the same currency, otherwise
// an InvalidArgumentException will be thrown:
$value4 = Money::EUR(100);
$result = $value1->compare($value4);        // throws InvalidArgumentException
```

--------------------------------

### Round to unit with roundToUnit()

Source: https://github.com/moneyphp/money/blob/master/doc/features/operation.rst

Rounds a Money amount to a specified number of decimal places. The result is a new Money object.

```php
$value = Money::EUR(813);           // €8.13

$result = $value->roundToUnit(2);   // Money::EUR(800)
$result = $value->roundToUnit(1);   // Money::EUR(810)
```

--------------------------------

### equals() method

Source: https://github.com/moneyphp/money/blob/master/doc/features/comparison.rst

Checks if two Money objects are equal in value and currency. Returns true only if both value and currency match.

```php
$value1 = Money::USD(800);              // $8.00
$value2 = Money::USD(800);              // $8.00
$value3 = Money::EUR(800);              // €8.00

$result = $value1->equals($value2);     // true
$result = $value1->equals($value3);     // false
```

--------------------------------

### Subtract multiple Money objects with variadic subtract()

Source: https://github.com/moneyphp/money/blob/master/doc/features/operation.rst

Subtracts multiple Money objects in a single call using variadic arguments.

```php
$value1 = Money::EUR(1400);                    // €14.00
$value2 = Money::EUR(500);                     // €5.00
$value3 = Money::EUR(600);                     // €6.00

$result = $value1->subtract($value2, $value3); // €3.00
```

--------------------------------

### Divide a Money object with divide()

Source: https://github.com/moneyphp/money/blob/master/doc/features/operation.rst

Divides a Money object by a numeric divisor. The result is a new Money object.

```php
$value = Money::EUR(800);       // €8.00

$result = $value->divide(2);    // €4.00
```

--------------------------------

### Ratio of two Money objects with ratioOf()

Source: https://github.com/moneyphp/money/blob/master/doc/features/operation.rst

Computes the ratio of one Money object to another. The result is a numeric value, not a Money object.

```php
$three = Money::EUR(300);        // €3.00
$six = Money::EUR(600);          // €6.00

$result = $three->ratioOf($six); // 0.5
$result = $six->ratioOf($three); // 2
```

--------------------------------

### AggregateMoneyParser usage

Source: https://github.com/moneyphp/money/blob/master/doc/features/parsing.rst

Collects multiple parsers and chooses the most appropriate one based on success to parse. Most parsers throw an exception when the string's format is not supported. Useful for using one parser as a service in DI context.

```php
use Money\Parser\AggregateMoneyParser;
use Money\Parser\BitcoinMoneyParser;
use Money\Parser\IntlMoneyParser;

$numberFormatter = new \NumberFormatter('en_US', \NumberFormatter::CURRENCY);
$intlParser = new IntlMoneyParser($numberFormatter, 2);
$bitcoinParser = new BitcoinMoneyParser(2);

$moneyParser = new AggregateMoneyParser([
    $intlParser,
    $bitcoinParser,
]);

$dollars = $moneyParser->parse('1 USD');
$bitcoin = $moneyParser->parse("Ƀ1.00");
```

--------------------------------

### IntlMoneyParser usage

Source: https://github.com/moneyphp/money/blob/master/doc/features/parsing.rst

Parses a currency-formatted string using the intl extension and NumberFormatter. Requires the intl extension and a currency repository. Results may vary across environments.

```php
use Money\Currencies\ISOCurrencies;
use Money\Parser\IntlMoneyParser;

$currencies = new ISOCurrencies();

$numberFormatter = new \NumberFormatter('en_US', \NumberFormatter::CURRENCY);
$moneyParser = new IntlMoneyParser($numberFormatter, $currencies);

$money = $moneyParser->parse('$1.00');

echo $money->getAmount(); // outputs 100
```

--------------------------------

### DecimalMoneyParser usage

Source: https://github.com/moneyphp/money/blob/master/doc/features/parsing.rst

Parses a simple decimal string in a consistent format independent of locale. Requires a currency repository to provide the correct subunit.

```php
use Money\Currency;
use Money\Currencies\ISOCurrencies;
use Money\Parser\DecimalMoneyParser;

$currencies = new ISOCurrencies();

$moneyParser = new DecimalMoneyParser($currencies);

$money = $moneyParser->parse('1000', new Currency('USD'));

echo $money->getAmount(); // outputs 100000
```

--------------------------------

### Replace float math with Teller::USD()

Source: https://github.com/moneyphp/money/blob/master/doc/features/teller.rst

Shows the before and after of using Teller to replace float math. The before uses float multiplication, resulting in 11.728, while the after uses Teller::multiply() and returns '11.73'. Note that Teller can only be used with one currency.

```php
// before
$price = 234.56;
$discount = 0.05;
$discountAmount = $price * $discount; // 11.728

// after
$teller = \Money\Teller::USD();
$discountAmount = $teller->multiply($price, $discount); // '11.73'
```

--------------------------------

### Add two Money objects with add()

Source: https://github.com/moneyphp/money/blob/master/doc/features/operation.rst

Adds two Money objects of the same currency. The result is a new Money object because operations are immutable.

```php
$value1 = Money::EUR(800);       // €8.00
$value2 = Money::EUR(500);       // €5.00

$result = $value1->add($value2); // €13.00
```

--------------------------------

### DecimalMoneyFormatter usage

Source: https://github.com/moneyphp/money/blob/master/doc/features/formatting.rst

Outputs a simple decimal string in a consistent format independent of locale. Requires ISOCurrencies.

```php
use Money\Currencies\ISOCurrencies;
use Money\Currency;
use Money\Formatter\DecimalMoneyFormatter;
use Money\Money;

$money = new Money(100, new Currency('USD'));
$currencies = new ISOCurrencies();

$moneyFormatter = new DecimalMoneyFormatter($currencies);

echo $moneyFormatter->format($money); // outputs 1.00
```

--------------------------------

### Exchanger Exchange Conversion

Source: https://github.com/moneyphp/money/blob/master/doc/features/currency-conversion.rst

Uses ExchangerExchange with an ExchangeRateProvider implementation to convert EUR to USD and demonstrates convertAndReturnWithCurrencyPair.

```php
use Money\Money;
use Money\Converter;
use Money\Currencies\ISOCurrencies;
use Money\Exchanger\ExchangerExchange;

// $exchanger = Implementation of \Exchanger\Contract\ExchangeRateProvider
$exchange = new ExchangerExchange($exchanger);

$converter = new Converter(new ISOCurrencies(), $exchange);
$eur100 = Money::EUR(100);
$usd125 = $converter->convert($eur100, new Currency('USD'));
[$usd125, $pair] = $converter->convertAndReturnWithCurrencyPair($eur100, new Currency('USD'));
```

--------------------------------

### IntlMoneyFormatter usage

Source: https://github.com/moneyphp/money/blob/master/doc/features/formatting.rst

Uses NumberFormatter with CURRENCY style to format money with currency symbol. Requires intl extension and ISOCurrencies. Output may vary across environments.

```php
use Money\Currencies\ISOCurrencies;
use Money\Currency;
use Money\Formatter\IntlMoneyFormatter;
use Money\Money;

$money = new Money(100, new Currency('USD'));
$currencies = new ISOCurrencies();

$numberFormatter = new \NumberFormatter('en_US', \NumberFormatter::CURRENCY);
$moneyFormatter = new IntlMoneyFormatter($numberFormatter, $currencies);

echo $moneyFormatter->format($money); // outputs $1.00
```

--------------------------------

### AggregateMoneyFormatter usage

Source: https://github.com/moneyphp/money/blob/master/doc/features/formatting.rst

Collects multiple formatters and chooses the most appropriate one based on currency code. Useful for DI context to support multiple currencies.

```php
use Money\Currencies\BitcoinCurrencies;
use Money\Currencies\ISOCurrencies;
use Money\Currency;
use Money\Formatter\AggregateMoneyFormatter;
use Money\Formatter\BitcoinMoneyFormatter;
use Money\Formatter\IntlMoneyFormatter;
use Money\Money;

$dollars = new Money(100, new Currency('USD'));
$bitcoin = new Money(100, new Currency('XBT'));

$numberFormatter = new \NumberFormatter('en_US', \NumberFormatter::CURRENCY);
$intlFormatter = new IntlMoneyFormatter($numberFormatter, new ISOCurrencies());
$bitcoinFormatter = new BitcoinMoneyFormatter(7, new BitcoinCurrencies());

$moneyFormatter = new AggregateMoneyFormatter([
    'USD' => $intlFormatter,
    'XBT' => $bitcoinFormatter,
]);

echo $moneyFormatter->format($dollars); // outputs $1.00
echo $moneyFormatter->format($bitcoin); // outputs Ƀ0.0000010
```

--------------------------------

### Subtract one Money object with subtract()

Source: https://github.com/moneyphp/money/blob/master/doc/features/operation.rst

Subtracts one Money object from another. The result is a new Money object.

```php
$value1 = Money::EUR(800);            // €8.00
$value2 = Money::EUR(500);            // €5.00

$result = $value1->subtract($value2); // €3.00
```

--------------------------------

### isSameCurrency() with variadic arguments

Source: https://github.com/moneyphp/money/blob/master/doc/features/comparison.rst

Tests whether all provided Money objects share the currency of the target using spread operator. Returns false if any has a different currency.

```php
$target = Money::USD(800);
$containsEuros = [
    Money::USD(500),
    Money::EUR(800)
];
$allDollars = [
    Money::USD(500),
    Money::USD(600),
];
$result = $target->isSameCurrency(...$containsEuros); // false
$result = $target->isSameCurrency(...$allDollars);    // true
```

--------------------------------

### Multiply a Money object with multiply()

Source: https://github.com/moneyphp/money/blob/master/doc/features/operation.rst

Multiplies a Money object by a numeric factor. The result is a new Money object.

```php
$value = Money::EUR(800);       // €8.00

$result = $value->multiply(2);  // €16.00
```

--------------------------------

### lessThan() method

Source: https://github.com/moneyphp/money/blob/master/doc/features/comparison.rst

Checks if the first Money object is less than the second. Returns true/false.

```php
$value1 = Money::USD(800);              // $8.00
$value2 = Money::USD(700);              // $7.00

$result = $value1->lessThan($value2);   // false
```

--------------------------------

### Serialize Money to JSON

Source: https://github.com/moneyphp/money/blob/master/doc/concept.rst

Serializes a Money object to JSON using json_encode. The output is a JSON string with the amount and currency fields.

```php
use Money\Money;

$money = Money::USD(350);
$json = json_encode($money);
echo $json; // outputs '{"amount":"350","currency":"USD"}'
```

--------------------------------

### lessThanOrEqual() method

Source: https://github.com/moneyphp/money/blob/master/doc/features/comparison.rst

Checks if the first Money object is less than or equal to the second.

```php
$value1 = Money::USD(800);                      // $8.00
$value2 = Money::USD(800);                      // $8.00

$result = $value1->lessThanOrEqual($value2);    // true
```

--------------------------------

### Reversed Currencies Exchange

Source: https://github.com/moneyphp/money/blob/master/doc/features/currency-conversion.rst

Wraps a FixedExchange in ReversedCurrenciesExchange to allow reverse conversions, converting 125 USD to EUR.

```php
use Money\Converter;
use Money\Currency;
use Money\Currencies\ISOCurrencies;
use Money\Exchange\FixedExchange;
use Money\Exchange\ReversedCurrenciesExchange;

$exchange = new ReversedCurrenciesExchange(new FixedExchange([
    'EUR' => [
        'USD' => '1.25'
    ]
]));

$converter = new Converter(new ISOCurrencies(), $exchange);

$usd125 = Money::USD(125);
$eur100 = $converter->convert($usd125, new Currency('EUR'));
```

--------------------------------

### IntlLocalizedDecimalParser usage

Source: https://github.com/moneyphp/money/blob/master/doc/features/parsing.rst

Parses a localized decimal string using the intl extension and NumberFormatter. Requires the intl extension and a currency repository. Results may vary across environments.

```php
use Money\Currency;
use Money\Currencies\ISOCurrencies;
use Money\Parser\IntlLocalizedDecimalParser;

$currencies = new ISOCurrencies();

$numberFormatter = new \NumberFormatter('nl_NL', \NumberFormatter::DECIMAL);
$moneyParser = new IntlLocalizedDecimalParser($numberFormatter, $currencies);

$money = $moneyParser->parse('1.000,00', new Currency('EUR'));

echo $money->getAmount(); // outputs 100000
```

--------------------------------

### Absolute value with absolute()

Source: https://github.com/moneyphp/money/blob/master/doc/features/operation.rst

Returns the absolute value of a Money object, turning negative amounts into positive.

```php
$value = Money::EUR(-800);       // -€8.00

$result = $value->absolute();    // €8.00
```

--------------------------------

### greaterThan() method

Source: https://github.com/moneyphp/money/blob/master/doc/features/comparison.rst

Checks if the first Money object is larger than the second. Requires same currency.

```php
$value1 = Money::USD(800);                  // $8.00
$value2 = Money::USD(700);                  // $7.00

$result = $value1->greaterThan($value2);    // true
```

--------------------------------

### isSameCurrency() with two Money objects

Source: https://github.com/moneyphp/money/blob/master/doc/features/comparison.rst

Checks if two Money objects have the same currency. Returns true if both have the same currency, false otherwise.

```php
$value1 = Money::USD(800);                      // $8.00
$value2 = Money::USD(100);                      // $1.00
$value3 = Money::EUR(800);                      // €8.00

$result = $value1->isSameCurrency($value2);    // true
$result = $value1->isSameCurrency($value3);    // false
```

--------------------------------

### greaterThanOrEqual() method

Source: https://github.com/moneyphp/money/blob/master/doc/features/comparison.rst

Checks if the first Money object is greater than or equal to the second.

```php
$value1 = Money::USD(800);                          // $8.00
$value2 = Money::USD(800);                          // $8.00

$result = $value1->greaterThanOrEqual($value2);     // true
```

--------------------------------

### Modulus operation with mod()

Source: https://github.com/moneyphp/money/blob/master/doc/features/operation.rst

Computes the remainder when one Money object is divided by another. Both must be in the same currency.

```php
$value = Money::EUR(830);        // €8.30
$divisor = Money::EUR(300);      // €3.00

$result = $value->mod($divisor); // €2.30
```

--------------------------------

### IntlLocalizedDecimalFormatter usage

Source: https://github.com/moneyphp/money/blob/master/doc/features/formatting.rst

Uses NumberFormatter with DECIMAL style to format money as localized decimal without currency sign. Requires intl extension and ISOCurrencies. Output may vary across environments.

```php
use Money\Currencies\ISOCurrencies;
use Money\Currency;
use Money\Formatter\IntlLocalizedDecimalFormatter;
use Money\Money;

$money = new Money(100000, new Currency('EUR'));
$currencies = new ISOCurrencies();

$numberFormatter = new \NumberFormatter('nl_NL', \NumberFormatter::DECIMAL);
$moneyFormatter = new IntlLocalizedDecimalFormatter($numberFormatter, $currencies);

echo $moneyFormatter->format($money); // outputs 1.000,00
```
Tokens:
Raw