szunisoft/laravel-mnb

Laravel MNB (Magyar Nemzeti Bank)

Downloads

315

Stars

3

Version

v2.0.1

Laravel-MNB

Requirements

Package requires Soap and version 7.1 of PHP or higher.

Know-how

This package was built on top of this MNB package. Please check out for corresponding documentations.

Install

composer require szunisoft/laravel-mnb

Configuration

Export

php artisan vendor:publish --provider="SzuniSoft\Mnb\Laravel\MnbServiceProvider" --tag="config"

config/mnb-exchange.php

    /*
     * Wsdl file location.
     * */
    'wsdl' => env('MNB_SOAP_WSDL', 'http://www.mnb.hu/arfolyamok.asmx?wsdl'),

    'cache' => [

        /*
         * Desired cache driver for service.
         * */
        'store' => env('MNB_CACHE_DRIVER', 'file'),

        /*
         * Minutes the cached currencies will be held for.
         * Default: 24hrs (1440)
         * */
        'minutes' => env('MNB_CACHE_MINUTES', 1440),
    ]

Usage

Access via facade

use SzuniSoft\Mnb\Laravel\Facade\Mnb

$currency = Mnb::currentExchangeRate('EUR');

Resolve by application container

$currency = app(\SzuniSoft\Mnb\Laravel\Client::class)->currentExchangeRate('EUR');

Access refresh date by reference

You can check the feed date by passing a $date variable to some methods. These methods will make variable to be a Carbon instance.

Mnb::exchangeRates($date);
$date->isToday();

Available methods

Won't use cache

These methods won't use and update cache.

  • currentExchangeRate($code, &$date = null): Currency
  • currentExchangeRates(&$date = null): array of Currency

Will use cache

These methods will use cache.

  • exchangeRate($code, &$date = null): single Currency
  • exchangeRates(&$date = null): array of currencies
  • currencies(): array of strings (each is currency code)
  • hasCurrency($code): bool
SzuniSOFT

Author

SzuniSOFT