nabarabane/cbr

Курсы валют ЦБ РФ

Курсы валют ЦБ России

Библиотека для получения и парсинга XML-данных ЦБ России о курсах валют., _(*1)

Доступные ресурсы

• Справочник валют
• Котировки на заданный день
• Динамика котировок за период времени

Вывод данных: XML или PHP-массив., _(*2)

Установка

Composer

composer require webdenis77/cbr:^2.0

Обычная

Скачайте и распакуйте архив с библиотекой в нужное вам место, затем подключите автолоадер библиотеки:, _(*3)

require('path-to-package/autoloader.php');

Использование

Справочник валют

http://www.cbr.ru/scripts/XML_valFull.asp, _(*4)

<?php

try {

    $resource = new \CBR\Catalog();

    $result = $resource
        // Опционально, фильтр по типам валют
        ->setType(\CBR\Catalog::TYPE_DAILY) // Валюты, устанавливаемые ежедневно (по умолчанию)
        ->setType(\CBR\Catalog::TYPE_MONTHLY) // Валюты, устанавливаемые ежемесячно

        // Выполнение запроса 
        ->request()

        // Получение необработанного ответа
        ->getResultXML();

        // Получение обработанного ответа
        ->getResult();

} catch (\Exception $e) {
    // Обработка исключения
}

Котировки на заданный день

http://www.cbr.ru/scripts/XML_daily.asp, _(*5)

<?php

try {

    $resource = new \CBR\CurrencyDaily();

    $result = $resource
        // Опционально, дата в становленном формате
        ->setDateFormat('d/m/Y')
        ->setDate('20/07/2015')

        ->setDateFormat('Y-m-d')
        ->setDate('2015-07-20')

        // Опционально, фильтр по кодам валют в установленном формате
        ->setKeyFormat(\CBR\Resource::KEY_CHAR)
        ->setCurrencies(['USD', 'EUR'])

        ->setKeyFormat(\CBR\Resource::KEY_NUM)
        ->setCurrencies(['840', '978'])

        ->setKeyFormat(\CBR\Resource::KEY_ID)
        ->setCurrencies(['R01235', 'R01239'])

        // Выполнение запроса
        ->request()

        // Получение необработанного ответа
        ->getResultXML();

        // Получение обработанного ответа
        ->getResult();
        /* Вернется именованный массив
        Ключи - коды валют, установленные через ->setKeyFormat()
        По умолчанию - \CBR\Resource::KEY_CHAR */

    /* Дата обновления ставок в результате может не совпадать с той, которую вы указали
    (по выходным дням, например, ставки не обновляются).
    Актуальная дата, по которой вы получили информацию
    сохраняется в обработчике после вызова getResult() и ее можно получить так: */
    $result_date = $resource->getResultDate();
} catch (\Exception $e) {
    // Обработка исключения
}

Динамика котировок за период времени

<?php

try {
    $resource = new \CBR\CurrencyPeriod();

    $result = $resource
        // Даты "c" и "по" в установленном формате
        ->setDateFormat('d/m/Y')
        ->setInterval('20/06/2015', '20/07/2015')

        ->setDateFormat('Y-m-d')
        ->setInterval('2015-06-20', '2015-07-20')

        // Код валюты в формате Банка России 
        ->setCurrency('R01535')

        // Выполнение запроса
        ->request()

        // Получение необработанного ответа
        ->getResultXML();

        // Получение обработанного ответа
        ->getResult();
        /* Вернется именованный массив
        Ключи - дата в формате, установленном через >setDateFormat() */

} catch (\Exception $e) {
    // Обработка исключения
}