Download the PHP package orkhanahmadov/laravel-currencylayer without Composer

:currency_exchange: Laravel package for currencylayer.com

Simple Laravel package for integrating with currencylayer.com currency rates.

Requirements

• PHP 7.1 or higher
• Laravel 5.8 or higher

Installation

You can install the package via composer:

Publish package migration and config files:

Set your currencylayer.com access key in .env file:

You can find your access key in Currencylayer Dashboard.

Configuration

After publishing configuration file it will be available in config directory as currencylayer.php

It has following settings:

• access_key - currencylayer.com access key, by default uses value from .env file
• https_connection - if set to true all calls to currencylayer API endpoint will be over HTTPS, instead of default HTTP

Usage

You can type-hint Orkhanahmadov\LaravelCurrencylayer\Contracts\CurrencyService to inject it from container:

Anywhere outside container you can create instance of the service with app() helper:

You can also use provided facade:

Available methods

All methods save rates to database table when fetched.

live()

Method fetches live rates from currencylayer.com

First argument is source currency, second argument is converted currency. You can also pass instance of Orkhanahmadov\LaravelCurrencylayer\Models\Currency as a source currency.

To get live rates for multiple currencies, pass multiple currency codes:

rate()

Method fetches rates for given date from currencylayer.com

First argument is source currency, second argument is date, third argument is converted currency. You can also pass instance of Orkhanahmadov\LaravelCurrencylayer\Models\Currency as a source currency argument and instance of Carbon\Carbon as a date argument.

To get rates for multiple currencies, pass multiple currency codes:

Commands

Package comes with 2 commands:

php artisan currencylayer:live - fetches live rates and outputs the values. First argument is source currency, second and next arguments are target currencies:

This will fetch live rates for USD to EUR and USD to CHF.

php artisan currencylayer:rate - fetches rates for given date and outputs the values. First argument is source currency, second argument is date, third and next arguments are target currencies:

This will fetch rates for 2019-01-25 for USD to EUR and USD to CHF.

Models

Package comes with 2 database models:

• Orkhanahmadov\LaravelCurrencylayer\Models\Currency - stores each fetched currency codes
• Orkhanahmadov\LaravelCurrencylayer\Models\Rate - stores rate for each currency exchange based on timestamp

Currency model has rateFor() method you can use to get currency rate. First argument is target currency code or can be instance of Currency.

This will fetch latest USD to EUR rate.

You can also pass date or Carbon\Carbon instance as a second argument to get rates for that date:

Testing

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• Orkhan Ahmadov
• All Contributors

License

The MIT License (MIT). Please see License File for more information.