awmedia/swap

Exchange rates library for PHP

3.1.0 2017-03-27 05:29 UTC

Requires

• php: ^5.5 || ^7.0
• florianv/exchanger: ~0.3

Requires (Dev)

• php-http/guzzle6-adapter: ^1.0
• php-http/message: ^1.0
• phpunit/phpunit: ^4.8 || ^5.4
• psr/cache: ^1.0

MIT

• Florian Voutzinos

• money
• currency
• conversion
• Rate
• exchange rates

README

Currency exchange rates library for PHP

Swap allows you to retrieve currency exchange rates from various services such as Fixer or Yahoo and optionally cache the results. It is integrated to other libraries like moneyphp/money and provides a Symfony Bundle and a Laravel Package.

QuickStart

$ composer require florianv/swap php-http/message php-http/guzzle6-adapter

use Swap\Builder;

// Build Swap with Fixer.io
$swap = (new Builder())
    ->add('fixer')
    ->build();
    
// Get the latest EUR/USD rate
$rate = $swap->latest('EUR/USD');

// 1.129
$rate->getValue();

// 2016-08-26
$rate->getDate()->format('Y-m-d');

// Get the EUR/USD rate 15 days ago
$rate = $swap->historical('EUR/USD', (new \DateTime())->modify('-15 days'));

Documentation

The complete documentation can be found here.

Services

Here is the list of the currently implemented services.

Service	Base Currency	Quote Currency	Historical
Fixer	*	*	Yes
European Central Bank	EUR	*	Yes
Google	*	*	No
Open Exchange Rates	USD (free), * (paid)	*	Yes
Xignite	*	*	Yes
Yahoo	*	*	No
WebserviceX	*	*	No
National Bank of Romania	RON	*	No
Central Bank of the Republic of Turkey	*	TRY	No
Central Bank of the Czech Republic	*	CZK	No
Russian Central Bank	*	RUB	Yes
currencylayer	USD (free), * (paid)	*	Yes

Integrations

• A Symfony Bundle FlorianvSwapBundle
• A Laravel Package florianv/laravel-swap

Credits

• Florian Voutzinos
• All Contributors

License

The MIT License (MIT). Please see LICENSE for more information.