honhat/convert-currency

Laravel module for currency conversion functionalities

v1.0.0 2024-05-01 09:13 UTC

Requires

• php: >=7.4
• laravel/framework: ^8.0
• vendor/convert-currency: ^1.0.0

Requires (Dev)

• phpunit/phpunit: ^9.3

MIT

• Ho Nhat

• money
• currency
• conversion
• laravel
• exchange

README

Currency Conversion Module

Description:

This module provides functionalities to convert currencies between different units. It utilizes real-time exchange rates from reputable API sources to ensure the most accurate rates.

Features:

Convert between over 150 popular currencies. Utilizes real-time exchange rates from reputable API sources. Supports converting large amounts of currencies. Easy to integrate into web and mobile applications. Installation:

1. Install the module:

composer require honhat/convert-currency

1. Configure the module:

Add the following keys to your config/currency.php file:

API_KEY_CURRENCY = ENV('API_KEY_CURRENCY');
DATA_URL_CURRENCY = ENV('DATA_URL_CURRENCY');
MASTER_CURRENCY = .ENV('MASTER_CURRENCY', 'USD');

Replace your_api_key with your API key from the exchange rate API provider. Replace USD with the default currency you want to use.

1. Install a service provider:

This module requires a service provider to make exchange rate API calls. You can use any service provider that supports the ExchangeRateProviderInterface interface.

PHP
// config/services.php

$providers = [
    // ...
    Module\ConvertCurrency\Services\ExchangeRateProviders\FixerIoProvider::class,
];

Usage:

To use the module, you can inject the CurrencyService service into your class:

PHP
use Module\ConvertCurrency\Services\CurrencyService;

class MyController
{
    private $currencyService;

    public function __construct(CurrencyService $currencyService)
    {
        $this->currencyService = $currencyService;
    }

    public function convertCurrency($amount, $fromCurrency, $toCurrency)
    {
        $convertedAmount = $this->currencyService->convert($amount, $fromCurrency, $toCurrency);

        return $convertedAmount;
    }
}

You can use the convert method to convert currencies:

PHP
$convertedAmount = $this->currencyService->convert(100, 'USD', 'EUR');