mibo/currency-rates

提供货币汇率和转换的PHP库

1.2.0 2024-08-03 11:11 UTC

This package is auto-updated.

Last update: 2024-09-03 11:20:24 UTC


README

codecov

在线货币汇率提供商。

该库包含 \MiBo\Currency\Rates\ExchangerInterface 接口,提供以下方法

  • getDefaultCurrency() - 返回交换器的默认货币代码(例如 USD)
  • getRateFor() - 返回给定货币代码的汇率。如果没有提供 'fromCurrency' 参数,则比较交换器的默认货币。
  • getExchangeRates() - 交换器的所有汇率列表。结果是数组,键是货币代码,'rate' 子键的值是给定货币代码的汇率。比较交换器的默认货币。如果存在 'amount' 子键,则根据给定金额计算汇率。
  • getAvailableCurrencies() - 返回交换器可用的货币列表。结果是货币代码的数组。

该库包含一些交换器的实现

  • ECB - 欧洲中央银行(自 1.0 版起)
  • CNB - 捷克国家银行(自 1.0 版起)
  • BoE - 英格兰银行(自 1.1 版起)
  • CF - Currency Freaks(自 1.2 版起)
  • OXR - Open Exchange Rates(自 1.2 版起)- 实验性
  • 更多即将推出...

所有实现都从公开资源加载汇率。所有资源都位于银行的官方网站上,因此汇率是可信的且最新的。

安装

composer require mibo/currency-rates

用法

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

库的未来

该库将包含更多交换器的实现。目标是提供一种简单的方式从各种来源获取货币汇率。主要关注全球公认的银行。