A PHP Library handles currency fx (rates & conversions) with ease. Battery-included ???.
Available for Laravel too.
Tired of implementing these and integrate with 3rd services? Let's CurrencyFX help you to do that. Covered by Unit Testing & battle-tested!
Simply initialize the class with the required params. And it is ready to use in no time.
$service = new CurrencyCloudService($host, $loginId, $apiKey);
$rateResponse = $service->getRates('USD', 'SGD');
if (!$rateResponse->isOk()) {
// failed to get the rate from third party service
// do something here
}
$rate = $rateResponse->getOkResult()->rate; // float (1.4xxx)
Requirement: Laravel 10+
Just simply install the package and lets Laravel discovery magic happens ?
Since we already bind the services in Laravel Container, all you have to do is update the ENVs and that's all.
php artisan vendor:publish --tag=currency-fx-configs
After published the config, checkout the configs/currency-fx.php
.
We already defined some ENVs key for you to add ?.
use CurrencyFXServicesCurrencyLayerService;
use CurrencyFXServicesExchangerRatesApiIoService;
// global access
app(CurrencyLayerService::class)->getRates('USD', 'EUR');
// DI
class TransferService
{
public function __construct(
private ExchangerRatesApiIoService $rateService
) {
}
public function transfer(): TransferResult
{
$rateRes = $this->rateService->getRates('EUR', 'GBP');
if ($rateRes->isError()) {
return TransferResult::error(...);
}
$rate = $rateRes->getOkResult()->rate;
}
}
We love tests, always. We have 3 kind of test cases:
Check out the TEST-README.md to learn more!
Feel free to add more driver and share it to the whole PHP community ?
Thank you, please give it a ️️️ to support the project.
Don't forget to share with your friends & colleagues, so they can also build their own SaaS products as well
MIT LICENSE
ShipSaas, Seth Phat & Contributors