Currency Package

• Website
• License
• Version: dev

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.

Installation

Download and install composer from http://www.getcomposer.org/download

Add the following to your project composer.json file

{
    "require": {
        "moltin/currency": "dev-master"
    }
}

When you're done just run php composer install and the package is ready to be used.

Overriding the config

Overriding the default configurations is done in a published config file. You can create it by typing:

$ php artisan config:publish moltin/currency

Usage

Below is a basic usage guide for this package.

Instantiating currency

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\Storage\Session as SessionStore;
use Moltin\Currency\Currencies\File as FileCurrencies;
use Moltin\Currency\Exchange\File as FileExchange;

$exchange = new FileExchange(new SessionStore, new FileCurrencies, array('base' => 'GBP'));
$currency = new Currency($exchange, 9.33);

Getting the value

The most basic action you can perform is rertieve the original value back from the method.

// Returns 9.33
$value = $currency->value();

Formatting as a currency

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->currency();

Rounding to common values

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()->currency();

Currency Exchange

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('USD')->currency();

// Returns ~14.50
$value = $currency->convert('USD')->fifty();

Resetting the 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();