shipsaas/currency-fx

A PHP Library handles Currency FX from multiple online FX services. Battery-included.

1.0.0 2023-04-17 09:04 UTC

This package is auto-updated.

Last update: 2024-11-17 12:42:09 UTC


README

codecov Unit Test (PHP 8.1, 8.2) Integration Test E2E Test

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!

Available Services / Batteries

Supports

  • PHP 8.1+

Dependencies

  • Guzzle for API Requests
  • NeverThrow for straightforward OK/Error response.

Usage

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)

Laravel Integration

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.

Export the configuration

php artisan vendor:publish --tag=currency-fx-configs

Update ENVs

After published the config, checkout the configs/currency-fx.php.

We already defined some ENVs key for you to add 😜.

Usage

use CurrencyFX\Services\CurrencyLayerService;
use CurrencyFX\Services\ExchangerRatesApiIoService;

// 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;
    }
}

Tests

We love tests, always. We have 3 kind of test cases:

  • Unit Tests
  • Integration Tests
  • E2E Tests

Check out the TEST-README.md to learn more!

Contribute to the project

  • All changes must follow PSR-1 / PSR-12 coding conventions.
  • Unit testing is a must, cover things as much as you can.

Feel free to add more driver and share it to the whole PHP community 😆

This library is useful?

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 🚀

License

MIT LICENSE

Contributors

ShipSaas, Seth Phat & Contributors