README

Requirements

Package requires Soap, SimpleXML and version 8.2 of PHP or higher.

Know-how

Please check out for corresponding documentations.

Install

composer require csaba215/laravel-mnb

Configuration

Export

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

config/mnb-exchange.php

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

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

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

        /*
         * Desired cache key prefix.
         * */
        'key' => env('MNB_CACHE_KEY', 'mnb'),
    ],
];

Usage

Access via facade

use Csaba215\Mnb\Laravel\Facade\Mnb

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

Resolve by application container

$currency = app(\Csaba215\Mnb\Laravel\Client::class)->exchangeRate('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::exchangeRate("EUR", "2025-04-22");

Available methods

Will use cache

These methods will use cache.

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