Caution: The documentation you are viewing is for an older version of Zend Framework.
You can find the documentation of the current version at:
https://docs.zendframework.com/

Exchanging currencies - Zend_Currency

Exchanging currencies

Within the previous section we discussed currency calculations. But as you can imaging calculating currencies does often mean to calculate different currencies from different countries.

In this case the currencies have to be exchanged so that both use the same currency. Within real live this information is available by banks or by daily papers. But as we are in web, we should use available exchange services. Zend_Currency allows their usage with a simple callback.

First let's write a simple exchange service.

class SimpleExchange implements Zend_Currency_CurrencyInterface
{
    public function getRate($from, $to)
    {
        if ($from !== "USD") {
            throw new Exception('We can only exchange USD');
        }
 
        switch ($to) {
            case 'EUR':
                return 2;
            case 'JPE':
                return 0.7;
       }
 
       throw new Exception('Unable to exchange $to');
    }
}

We have now created a manual exchange service. It will not fit the real live, but it shows you how currency exchange works.

Your exchange class must implement the Zend_Currency_CurrencyInterface interface. This interface requires the single method getRate() to be implemented. This method has two parameters it will receive. Both are the short names for the given currencies. Zend_Currency on the other side needs the exchange rate to be returned.

In a living exchange class you would probably ask the service provider for the correct exchange rates. For our example the manual rate will be ok.

Now we will simply attach our exchange class with Zend_Currency. There are two ways to do this. Eigher by attaching a instance of the Exchange class, or by simply giving a string with the classname.

$currency = new Zend_Currency(
    array(
        'value'    => 1000,
        'currency' => 'EUR',
    )
);
 
$service  = new SimpleExchange();
 
// attach the exchange service
$currency->setService($service);
 
$currency2 = new Zend_Currency(
    array(
        'value'    => 1000,
        'currency' => 'USD',
    )
);
 
print $currency->add($currency2);

The above example will return '$ 3.000' because the 1.000 USD will be converted by a rate of 2 to 2.000 EUR.

Note: Calculation without exchange service
When you try to calculate two currency objects which do not use the same currency and have no exchange service attached, you will get an exception. The reason is that Zend_Currency is then not able to switch between the different currencies.

Select a version:

Zend_Currency

Previous topic

Calculating with currencies

Next topic

Additional informations on Zend_Currency

Documentation

Exchanging currencies

Previous topic

Next topic

Copyright

Contacts