Documentation

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.

  1. class SimpleExchange implements Zend_Currency_CurrencyInterface
  2. {
  3.     public function getRate($from, $to)
  4.     {
  5.         if ($from !== "USD") {
  6.             throw new Exception('We can only exchange USD');
  7.         }
  8.  
  9.         switch ($to) {
  10.             case 'EUR':
  11.                 return 2;
  12.             case 'JPE':
  13.                 return 0.7;
  14.        }
  15.  
  16.        throw new Exception('Unable to exchange $to');
  17.     }
  18. }

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.

  1. $currency = new Zend_Currency(
  2.     array(
  3.         'value'    => 1000,
  4.         'currency' => 'EUR',
  5.     )
  6. );
  7.  
  8. $service  = new SimpleExchange();
  9.  
  10. // attach the exchange service
  11. $currency->setService($service);
  12.  
  13. $currency2 = new Zend_Currency(
  14.     array(
  15.         'value'    => 1000,
  16.         'currency' => 'USD',
  17.     )
  18. );
  19.  
  20. 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.

Copyright

© 2006-2021 by Zend by Perforce. Made with by awesome contributors.

This website is built using zend-expressive and it runs on PHP 7.

Contacts