Download the PHP package orkhanahmadov/currencylayer without Composer
On this page you can find all versions of the php package orkhanahmadov/currencylayer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download orkhanahmadov/currencylayer
More information about orkhanahmadov/currencylayer
Files in orkhanahmadov/currencylayer
Package currencylayer
Short Description PHP client for currencylayer.com
License MIT
Homepage https://github.com/orkhanahmadov/currencylayer
Informations about the package currencylayer
:currency_exchange: PHP client for currencylayer.com
Simple PHP client for currencylayer.com currency rates.
Installation
You can install the package via composer:
Usage
Instantiate Orkhanahmadov\Currencylayer\CurrencylayerClient
class and pass your "access key"
You can find your access key in Currencylayer Dashboard.
If you are using paid plan, you can use HTTPS connection to currencylayer.com API.
While instantiating pass true
as second parameter to use HTTPS connection.
Available methods
quotes()
Use this method to fetch live and historical currency rates.
Pass source currency to source()
method and rate currency currency()
method.
Following example will fetch live rates from USD to EUR.
You can also pass multiple rate currencies to currency()
method:
If you want fetch rates for specific date, you can pass the date to date()
method.
date()
method accepts dates as string or instance of DateTimeInterface
.
quotes()
method returns instance of Orkhanahmadov\Currencylayer\Data\Quotes
.
This class has following methods that you can use:
source()
- Returns source currency (for example,USD
)timestamp()
- Returns timestamp value from currencylayer API (for example,1432400348
)quotes()
- Returns array of quotes from currencylayer APIdate()
- ReturnsDateTimeInterface
date. If you fetched live rates this method will returnnull
You can also get rates for each fetched currency using currency name as property:
convert()
Use this method to convert amount in one currency to another currency.
Pass source currency to source()
method, rate currency currency()
method and amount to convert()
method.
Following example will convert 10 USD to GBP using live rates.
If you want conversion based on different date's rates, you can pass the date to date()
method.
date()
method accepts dates as string or instance of DateTimeInterface
.
convert()
method returns instance of Orkhanahmadov\Currencylayer\Data\Conversion
.
This class has following methods that you can use:
fromCurrency()
- Returns source currency (for example,USD
)toCurrency()
- Returns target currency (for example,GBP
)timestamp()
- Returns timestamp value from currencylayer API (for example,1432400348
)amount()
- Returns amount that passed toconvert()
method (for example,10
)quote()
- Returns quote between source and target currencies (for example,0.658443
)result()
- Returns conversion result (for example6.58443
)date()
- ReturnsDateTimeInterface
date. If you fetched live rates this method will returnnull
timeframe()
Use this method to show rates between given dates.
Pass source currency to source()
method, rate currencies to currency()
method and
start date as first argument and end date as second argument to timeframe()
method.
Start and end dates can be string of dates or instances of DateTimeInterface
.
Following example will return timeframe rates from USD to GBP and EUR between 2010-03-01
and 2010-04-01
.
timeframe()
method returns instance of Orkhanahmadov\Currencylayer\Data\Timeframe
.
This class has following methods that you can use:
source()
- Returns source currency (for example,USD
)startDate()
- ReturnsDateTimeInterface
start dateendDate()
- ReturnsDateTimeInterface
start dateallQuotes()
- Returns array quotes grouped by each day between start and end datequotes()
- Accepts string date or instance ofDateTimeInterface
and returns rates for that day
You can also use currency code as function call and pass date to get rates:
change()
Use this method to show currency rate change between given dates.
Pass source currency to source()
method, rate currencies to currency()
method and
start date as first argument and end date as second argument to change()
method.
Start and end dates can be string of dates or instances of DateTimeInterface
.
Following example will return rate change from USD to GBP and EUR between 2010-03-01
and 2010-04-01
.
change()
method returns instance of Orkhanahmadov\Currencylayer\Data\Change
.
This class has following methods that you can use:
source()
- Returns source currency (for example,USD
)startDate()
- ReturnsDateTimeInterface
start dateendDate()
- ReturnsDateTimeInterface
start datequotes()
- Returns array of currency change rates between start and end daterate()
- Accepts currency code as an argument and returns currency rate for given start dateendRate()
- Accepts currency code as an argument and returns currency rate for given end dateamount()
- Accepts currency code as an argument and currency rate's change in amountpercentage()
- Accepts currency code as an argument and currency rate's change in percentage
list()
Use this method to get list of all available currencies.
Method will return array of currencies in currencyCode => currencyName
structure.
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.