brightcreations/money-converter

A Laravel package for converting currencies using exchange rates.

v0.1.2 2025-06-03 11:01 UTC

Requires

• php: >=8.1
• brick/money: ^0.10.1
• brightcreations/exchange-rates: *
• illuminate/console: ^10.0 || ^11.0 || ^12.0
• illuminate/database: ^10.0 || ^11.0 || ^12.0
• illuminate/http: ^10.0 || ^11.0 || ^12.0
• illuminate/support: ^9.0|^10.0|^11.0|^12.0

MIT

• Bright Creations

• currency conversion
• laravel
• exchange rates

README

A PHP package for converting money between different currencies.

Overview

This package provides a simple and efficient way to convert money between different currencies. It uses a unified interface to fetch exchange rates and perform conversions, making it easy to integrate with various exchange rate services.

Features

• Converts money between different currencies
• Uses a unified interface to fetch exchange rates and perform conversions
• Supports multiple exchange rate services
• Throws exceptions for invalid conversions or missing exchange rates
• Easy to integrate with various frameworks and applications

Installation

To install the Exchange Rates Service package, run the following command in your terminal:

composer require brightcreations/money-converter

Configuration

To configure the package, publish the configuration file using the following command:

php artisan vendor:publish --provider="BrightCreations\MoneyConverter\MoneyConverterServiceProvider"

Then, update the money-converter.php configuration file to suit your needs.

Usage

To retrieve exchange rates, use the MoneyConverterInterface:

use BrightCreations\MoneyConverter\Contracts\MoneyConverterInterface;

// Converts 100.00 USD to EUR using the current exchange rate
$convertedMinorInt = $service->convert(10000, 'USD', 'EUR');

// Converts 100.00 USD to EUR using the exchange rate of a previous date
$convertedMinorInt = $service->convert(10000, 'USD', 'EUR', now()->subDays(1));

Important Note: Before using the package, make sure that the tables of the exchange rates are in your database and the names of the tables and columns are reflected in the config as it is.

You can inject the service into a constructor or resolve it using the resolve or app->make method. Here are examples of each approach:

Constructor Injection

use BrightCreations\MoneyConverter\Contracts\MoneyConverterInterface;

class SomeClass {
    private $service;

    public function __construct(MoneyConverterInterface $service) {
        $this->service = $service;
    }

    public function someMethod() {
        $convertedMinorInt = $this->service->convert(10000, 'USD', 'EUR');
    }
}

Using resolve Method

use BrightCreations\MoneyConverter\Contracts\MoneyConverterInterface;

$service = resolve(MoneyConverterInterface::class);
$convertedMinorInt = $service->convert(10000, 'USD', 'EUR');

Using app->make Method

use BrightCreations\MoneyConverter\Contracts\MoneyConverterInterface;

$service = app()->make(MoneyConverterInterface::class);
$convertedMinorInt = $service->convert(10000, 'USD', 'EUR');

API Documentation

Coming soon...

Contributing

Contributions are welcome! Please submit a pull request or open an issue to report any bugs or suggest new features.

License

This package is licensed under the MIT License.

Author

Kareem Mohamed - Bright Creations Email: [e-mail]

Version

0.1.2