dostrog/larate

一个小型库,用于从 Laravel 访问俄罗斯中央银行(CBRF)和乌克兰国家银行(NBU)的货币汇率API

支持包维护!
dostrog

v1.0.5 2021-03-29 18:46 UTC

This package is auto-updated.

Last update: 2024-10-01 00:08:50 UTC


README

Latest Version on Packagist GitHub Code Style Action Status Total Downloads

概览

一个简单的Laravel包,用于与俄罗斯银行乌克兰国家银行的API交互。'Larate' 允许您获取RUB(UAH)与其他货币之间的最新或历史汇率。

安装

您可以通过composer安装此包

composer require dostrog/larate

您可以使用以下命令发布配置文件

php artisan vendor:publish --provider="Dostrog\Larate\Providers\LarateServiceProvider" --tag="config"

这是已发布配置文件的内容

return [
    'default_base_currency' => 'RUB',
    'service' => [
        'RUB' => Dostrog\Larate\Services\RussianCentralBank::class,
        'UAH' => Dostrog\Larate\Services\NationalBankOfUkraine::class,
    ],
];

用法

// instantiate from Laravel IoC for inject provider
// according to config it maybe RUB (converted) rates from Central Bank OF Russia
$provider = app()->make(Larate::class);
$pair = new CurrencyPair('RUB', 'USD');
$date = Carbon::parse('2020-01-16');
$rate = $provider->getExchangeRate($pair, $date);
$value = $rate->getValue(); // 61.4328

// ...or using factory method, i.e. for getting UAH (converted) rates from National Bank of Ukraine
$provider = Larate::createForBaseCurrency('UAH');
$pair = new CurrencyPair('UAH', 'USD');
$date = Carbon::parse('2020-01-16');
$rate = $provider->getExchangeRate($pair, $date);
$value = $rate->getValue(); // 23.9821

// ...or using Laravel's Facades
$rate = LarateFacade::getExchangeRate($pair, $date);
$value = $rate->getValue();

测试

composer test

变更日志

有关最近更改的更多信息,请参阅变更日志

贡献

有关详细信息,请参阅贡献指南

安全漏洞

有关报告安全漏洞的详细信息,请参阅我们的安全策略

致谢

许可

MIT许可(MIT)。有关更多信息,请参阅许可文件