Stars: 109
Forks: 22
Pull Requests: 8
Issues: 8
Watchers: 13
Last Updated: 2020-09-16 10:36:20
Handles currency calculations, storage etc
License: Other
Languages: PHP
The Moltin currency composer package makes it easy to implement multi-currency pricing into your application and store the exchange data using one of the numerous data stores provided. You can also inject your own data store if you would like your data to be stored elsewhere.
Download and install composer from http://www.getcomposer.org/download
Add the following to your project composer.json
file
{
"require": {
"moltin/currency": "~1.0.0"
}
}
When you're done just run php composer.phar install
and the package is ready to be used.
Below is a basic usage guide for this package.
Before you begin, you will need to know which storage, currencies and exchange method you are going to use. The exchange method defines where your exchange rates are retrieved from. The currencies method is used to retrieve your supported currencies for the current application.
In this example we're going to use the currencies file, exchange file and session for storage.
use Moltin\Currency\Currency as Currency;
use Moltin\Currency\Format\Runtime as RuntimeFormat;
use Moltin\Currency\Exchange\OpenExchangeRates as OpenExchange;
$currency = new Currency(new OpenExchange($app_id), new RuntimeFormat);
Now that you have Currency instantiated, you will now need to tell it what value you would like to convert. You can do this using the following method.
$currency->convert(9.33)->from('GBP');
The most basic action you can perform is retrieve the original value back from the method.
// Returns 9.33
$value = $currency->value();
By default the currency is set to GBP so calling currency will format the value to a string with £ and correct decimal and thousand seperators.
// Returns £9.33
$value = $currency->format();
There are a number of common pricing formats built in to make "nice" prices easy to implement. These formats changes the default value and return the object to allow for chaining.
// Sets value to 10.00
$currency->zeros();
// Sets value to 9.99
$currency->nines();
// Sets value to 9.50
$currency->fifty();
// Returns £9.50
$value = $currency->fifty()->format();
The package makes it as easy as possible to quickly switch between currencies. Before each exchange the value is reset to default to ensure the correct price is assigned.
// Returns ~$14.47
$value = $currency->convert(9.33)->from('GBP')->to('USD')->format();
// Returns ~14.50
$value = $currency->convert(9.33)->from('GBP')->to('USD')->fifty()->value();
After using exchange or any of the rounding functions to retrieve the default value you must call reset.
// Returns 10.00
$value = $currency->zeros()->value();
// Returns 9.33
$value = $currency->reset()->value();