Download the PHP package eljump/exchange-rate-fork without Composer
On this page you can find all versions of the php package eljump/exchange-rate-fork. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download eljump/exchange-rate-fork
More information about eljump/exchange-rate-fork
Files in eljump/exchange-rate-fork
Package exchange-rate-fork
Short Description Exchange rate of the Central Bank of the Russian Federation. Currency converter. Getting data from the Central Bank's website cbr.ru
License MIT
Informations about the package exchange-rate-fork
Получение курсов валют с сайта Центробанка России.
Система для получения курсов валют с официального сайта Центрального Банка России https://www.cbr.ru и конвертер валют. Fork.
Возможности пакета
- Получение по средствам API курсов валют с сайта Центробанка России по дате.
- Конвертирование одной валюты в другую.
Требования
- Версия PHP 7.3 и выше.
Установка
Для установки пакета следует выполнить команду:
Использование
Ниже приведены примеры использования пакета.
Получение курсов валют
Пример 1
Запрос данных о курсах валют, которые Центробанк России установил на дату 2020-02-19:
Результат (фрагмент):
Пример 2
Запрос данных валюты USD актуальных на дату 2020-07-12:
В этом примере мы запрашиваем коллекцию курсов валют CurrencyRateCollection и при помощи метода getCurrencyRateBySymbolCode('AMD') получаем элемент коллекции для валюты с символьным кодом AMD (Армянский драм).
Результат:
Обратите внимание на свойство quantity. Для валюты Армянский драм quantity равняется 100. Это значит, что 100 армянских драм стоят 14.6383 рублей.
Пример 3
Получение курса валюты AMD по отношению к рублю на указанную дату — 2020-09-30:
Результат:
Мы получили курс 1 армянского драма в рублях, который Центробанк РФ установил на дату 2020-09-30.
Конвертация курсов валют
Пример конвертации 73 224 долларов США в Евро по курсу, который был актуален 2020-06-10:
Результат:
73 224 долларов США равняется 65 012.87 евро по курсу Центробанка РФ, который был установлен на дату 2020-06-10.
Получение справочника по кодам валют
Пример 1
Получение перечня ежедневных валют:
Результат (фрагмент):
Пример 1
Получение перечня ежемесячных валют:
Результат (фрагмент):
Свойства модели CurrencyRate
Описание свойств модели CentralBankRussian\ExchangeRate\Models\CurrencyRate:
Свойство | Описание |
---|---|
$name | Название валюты на русском языке |
$exchangeRate | Обменный курс валюты, стоимость в рублях $quantity единиц валюты |
$quantity | Количество или номинал (темрмин ЦБ РФ) валюты, стоимость которой в рублях указана в свойстве $exchangeRate. |
$numericCode | ISO Цифровой код валюты |
$symbolCode | ISO Символьный код валюты |
Свойства модели Currency
Описание свойств модели CentralBankRussian\ExchangeRate\Models\Currency:
Свойство | Описание |
---|---|
$name | Название валюты на русском языке. |
$nameEng | Название валюты на английском языке. |
$quantity | Количество или номинал (термин ЦБ РФ) валюты, стоимость которой в рублях указана в свойстве $exchangeRate. |
$numericCode | ISO Цифровой код валюты. |
$symbolCode | ISO Символьный код валюты. |
$internalCode | Внутренний код валюты. Код для идентификации валют, является локальным и уникальным идентификатором валюты в данной базе ЦБ РФ. Необходим для использования в качестве параметра для методов GetCursDynamic (GetCursDynamicXML) |
$internalCommonCode | Внутренний код валюты, являющейся базовым в рамках базы данных ЦБ РФ. Этот код используется для связи, при изменениях кодов или названий фактически одной и той же валюты. |
Ссылка на описание web-сервиса ЦБ РФ
https://www.cbr.ru/development/DWS/
Лицензия (License)
MIT license