mibo/currency-rates

PHP Library that provides currency rates and conversions

1.1.5 2024-05-08 16:40 UTC

Requires

• php: ^8.2
• ext-xmlreader: *
• mibo/currencies: ^1.0
• nesbot/carbon: ^2.72|^3.3

Requires (Dev)

• jetbrains/phpstorm-attributes: ^1.0
• php-parallel-lint/php-parallel-lint: ^1.4
• phpstan/extension-installer: ^1.3
• phpstan/phpstan: ^1.10
• phpstan/phpstan-deprecation-rules: ^1.1
• phpstan/phpstan-strict-rules: ^1.5
• phpunit/php-invoker: ^5.0
• phpunit/phpunit: ^11.1
• slevomat/coding-standard: ^8.15
• squizlabs/php_codesniffer: ^3.9

MIT

• Michal Boris

• package
• php
• library
• money
• currency
• price
• Bank
• lib
• rates
• currencies
• cnb
• prices
• banks
• nbs
• currency rate
• MiBo

README

Online currency rate provider.

The library comes with \MiBo\Currency\Rates\ExchangerInterface interface, which provides the following methods:

• getDefaultCurrency() - returns default currency code of the Exchanger (e.g. USD)
• getRateFor() - returns rate for the given currency code. Comparing the default currency of the Exchanger if no 'fromCurrency' parameter is provided.
• getExchangeRates() - list of all exchange rates of the Exchanger. The result is an array where a key is a currency code and a value of 'rate' sub key is a rate for the given currency code. Comparing the default currency of the Exchanger. If 'amount' sub key is present, the rate is calculated for the given amount.
• getAvailableCurrencies() - returns list of available currencies of the Exchanger. The result is an array of currency codes.

The library comes with a few implementations of the Exchangers:

• ECB - European Central Bank
• CNB - Czech National Bank
• BoE - Bank of England
• more to come...

All implementations load the rates from publicly available resources. All resources are located on official websites of the banks, thus the rates are trustworthy and up to date.

Installation

composer require mibo/currency-rates

Usage

$price = 100; // EUR
$exchanger = new \MiBo\Currency\Rates\Exchangers\ECB();
$newPrice = $exchanger->getRateFor('USD') * $price; // USD

Future of the library

The library will contain more implementations of the Exchangers. The goal is to provide a simple way to get currency rates from various sources. The main focus is on the banks that are globally recognized.