, (*1)
Yii2 Currency Converter
, (*2)
This extension will help to find out current currency conversion rate using various providers., (*3)
Documentation is at docs/README.md., (*4)
Version 1 docs are located at here., (*5)
Requirements
- PHP version 7.4 or later
- Curl Extension (Optional)
Installation
The preferred way to install this extension is through composer., (*6)
Either run, (*7)
php composer.phar require --prefer-dist imanilchaudhari/yii2-currency-converter "3.1"
or add, (*8)
"imanilchaudhari/yii2-currency-converter": "3.1"
to the require section of your composer.json
file., (*9)
Usage
Once the extension is installed, use it in your code by adding the below code on the config's components :, (*10)
'components' => [
'currencyConverter' => [
'class' => 'imanilchaudhari\CurrencyConverter\CurrencyConverter',
'provider' => [
'class' => 'imanilchaudhari\CurrencyConverter\Provider\ExchangeRatesApi',
],
],
...
],
****and use as****, (*11)
$rate = Yii::$app->currencyConverter->convert('USD', 'NPR');
OR, (*12)
use imanilchaudhari\CurrencyConverter\CurrencyConverter;
use imanilchaudhari\CurrencyConverter\Provider\ExchangeRatesApi;
$converter = new CurrencyConverter([
'provider' => [
'class' => ExchangeRatesApi::class,
],
]);
$rate = $converter->convert('USD', 'NPR');
print_r($rate); // it will print the current Nepalese currency (NPR) rate according to USD
Exchange Rate Providers
-
ApiForexApi - Get exchange rates from https://api.forex/
-
CurrencyApi - Get exchange rates from https://currencyapi.com/
-
CurrencyFreaksApi - Get exchange rates from https://currencyfreaks.com/
-
CurrencylayerApi - Get exchange rates from https://currencylayer.com/
-
ExchangeRatesApi - Get exchange rates from https://www.exchangerate-api.com/ (Free, no billing required)
-
FixerApi - Get exchange rates from https://fixer.io/
-
OpenExchangeRatesApi - Get exchange rates from https://openexchangerates.org/
Testing
Unit testing
The package is tested with PHPUnit. To run tests:, (*13)
./vendor/bin/phpunit
License
The Yii2 Currency Converter is free software. It is released under the terms of the MIT License. Please see LICENSE
for more information., (*14)
, (*15)