currency fx

Библиотека currency fx PHP

Библиотека PHP с легкостью обрабатывает currency fx (курсы и конвертации). Батарея в комплекте???.

Доступно и для Laravel.

Устали реализовывать их и интегрировать со сторонними сервисами? Давайте CurrencyFX поможет вам в этом. Проведено модульное тестирование и проверено в бою!

Доступные услуги / Аккумуляторы

• https://exchangeratesapi.io/
• https://exchangerate.host/
• https://fixer.io/
• https://currencylayer.com/
• https://www.currencycleud.com/

Поддерживает

• PHP 8.1+

Зависимости

• Guzzle для запросов API
• NeverThrow для прямого ответа ОК/Ошибка.

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

Просто инициализируйте класс с необходимыми параметрами. И он готов к использованию в кратчайшие сроки.

 $ service = new CurrencyCloudService ( $ host , $ loginId , $ apiKey );
$ rateResponse = $ service -> getRates ( ' USD ' , ' SGD ' );

if (! $ rateResponse -> isOk ()) {
    // failed to get the rate from third party service
    // do something here
}

$ rate = $ rateResponse -> getOkResult ()-> rate ; // float (1.4xxx) 

Интеграция с Ларавелом

Требование: Laravel 10+.

Просто установите пакет и пусть произойдет волшебство открытия Laravel?

Поскольку мы уже привязываем сервисы к контейнеру Laravel, все, что вам нужно сделать, это обновить ENV и все.

Экспортируйте конфигурацию

php artisan vendor:publish --tag=currency-fx-configs

Обновить ENV

После публикации конфигурации проверьте configs/currency-fx.php .

Мы уже определили некоторые ключи ENV, которые вы можете добавить?.

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

 use CurrencyFX  Services  CurrencyLayerService ;
use CurrencyFX  Services  ExchangerRatesApiIoService ;

// global access
app (CurrencyLayerService::class)-> getRates ( ' USD ' , ' EUR ' );

// DI
class TransferService
{
    public function __construct (
        private ExchangerRatesApiIoService $ rateService
    ) {
    }
    
    public function transfer (): TransferResult
    {
        $ rateRes = $ this -> rateService -> getRates ( ' EUR ' , ' GBP ' );
        if ( $ rateRes -> isError ()) {
            return TransferResult:: error (...);
        }

        $ rate = $ rateRes -> getOkResult ()-> rate ;
    }
}

Тесты

Мы всегда любим тесты. У нас есть 3 типа тестовых случаев:

• Модульные тесты
• Интеграционные тесты
• E2E-тесты

Посетите TEST-README.md, чтобы узнать больше!

Внести свой вклад в проект

• Все изменения должны соответствовать правилам кодирования PSR-1/PSR-12.
• Модульное тестирование является обязательным, охватывайте как можно больше вещей.

Не стесняйтесь добавлять дополнительные драйверы и делиться ими со всем сообществом PHP?

Эта библиотека полезна?

Спасибо, пожалуйста, поставьте ️️️, чтобы поддержать проект.

Не забудьте поделиться с друзьями и коллегами, чтобы они также могли создавать свои собственные продукты SaaS.

Лицензия

ЛИЦЕНЗИЯ MIT

Авторы

ШипСаас, Сет Фат и участники