currency fx

PHP currency fx 라이브러리

PHP 라이브러리는 currency fx (환율 및 변환)를 쉽게 처리합니다. 배터리 포함 ???.

Laravel에서도 사용 가능합니다.

이를 구현하고 제3의 서비스와 통합하는 데 지치셨나요? 이를 수행할 수 있도록 MoneyFX가 도와드리겠습니다. 단위 테스트 및 전투 테스트를 거쳤습니다!

이용 가능한 서비스 / 배터리

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

지원

• PHP 8.1+

종속성

• API 요청에 대한 Guzzle
• 간단한 OK/Error 응답을 위한 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) 

라라벨 통합

요구사항: 라라벨 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 라이센스

기여자

ShipSaas, Seth Phat 및 기여자