library exchange {🖫 6,721, ⚐ 27, ★ 20}

h4kuna/exchange

Exchange between currencies.

Saturday, March 10, 2018
by h4kuna
Repository
5 Watchers
20 Stars
6,721 Installations

PHP
1 Dependents
0 Suggesters
9 Forks
1 Open issues
27 Versions
8 % Grown

The README.md

Exchange

, _(*1)

Exchange is PHP script works with currencies. You can convert price., _(*2)

Here is changelog., _(*3)

Extension for framework

Nette extension

Installation via composer

$ composer require h4kuna/exchange

Optional packages, _(*4)

$ composer require malkusch/lock guzzlehttp/guzzle guzzlehttp/psr7 h4kuna/dir nette/caching

Support PSR-6 for cache., _(*5)

How to use

Init object Exchange by ExchangeFactory. Default Driver for read is Cnb, here are others., _(*6)

For example define own exchange rates:, _(*7)

25 CZK = 1 EUR
20 CZK = 1 USD

use h4kuna\Exchange\Currency\Property;
use h4kuna\Exchange\Driver\Cnb\Day;
use h4kuna\Exchange\Exchange;
use h4kuna\Exchange\ExchangeFactory;
use h4kuna\Exchange\RatingList\CacheEntity;
use h4kuna\Exchange\RatingList\RatingList;

{ # by factory
    $exchangeFactory = new ExchangeFactory(
        from: 'eur',
        to: 'usd',
        allowedCurrencies: [
            'CZK',
            'USD',
            'eur', // lower case will be changed to upper case
        ],
    );

    $exchange = $exchangeFactory->create();
}

{ # custom RatingList
    $ratingList = new RatingList(new DateTimeImmutable(), new DateTimeImmutable(), null, [
        'EUR' => new Property(1, 25.0, 'EUR'),
        'USD' => new Property(1, 20.0, 'USD'),
        'CZK' => new Property(1, 1.0, 'CZK'),
    ]);
    $exchange = new Exchange('EUR', $ratingList, 'USD');
}

echo $exchange->change(100) . PHP_EOL; // EUR -> USD = 125.0

// use only upper case
echo $exchange->change(100, 'CZK') . PHP_EOL; // CZK -> USD = 5.0
echo $exchange->change(100, null, 'CZK') . PHP_EOL; // EUR -> CZK = 2500.0
echo $exchange->change(100, 'USD', 'CZK') . PHP_EOL; // USD -> CZK = 2000.0

Change driver and date

Download history exchange rates. Make new instance of Exchange with history rate., _(*8)

use h4kuna\Exchange\RatingList;
use h4kuna\Exchange;

$exchangePast = $exchangeFactory->create(cacheEntity: new CacheEntity(new Datetime('2000-12-30'), new Day));
echo $exchangePast->change(100) . PHP_EOL;

Access and iterator

use h4kuna\Exchange\Currency\Property;
/* @var $property Property */
$property = $exchange['EUR'];
var_dump($property);
echo PHP_EOL;

foreach ($exchange as $code => $property) {
    /* @var $property Property */
    var_dump($code, $property);
}

Caching

The cache invalid automatic at some time, defined by property SourceData::$refresh. From this property is counted time to live. Little better is invalid cache by cron. Because one request on server does not lock other requests. Let's run cron max. 29 minutes before invalidate cache., _(*9)

use h4kuna\Exchange\RatingList\RatingListCache;
use h4kuna\Exchange\RatingList\CacheEntity;
use h4kuna\Exchange\Driver\Cnb\Day;

/** @var RatingListCache $ratingListCache */
$ratingListCache->rebuild(new CacheEntity(null, new Day));

In example, is used h4kuna\Exchange\Driver\Cnb\Day::$refresh is defined at 14:30 + 30 minute the cache is valid. Run cron 14:32 every day., _(*10)

The Versions

10/03 2018

dev-php7.1

dev-php7.1 https://github.com/h4kuna/exchange

Exchange between currencies.

library exchange

Exchange between currencies.

h4kuna/exchange

The README.md

Exchange

Extension for framework

Installation via composer

How to use

Change driver and date

Access and iterator

Caching

The Versions

dev-php7.1

The Requires

The Development Requires

by Milan Matějček

dev-master

The Requires

The Development Requires

by Milan Matějček

v5.0.2

The Requires

The Development Requires

by Milan Matějček

v5.0.1

The Requires

The Development Requires

by Milan Matějček

v5.0.0

The Requires

The Development Requires

by Milan Matějček

v4.2.2

The Requires

The Development Requires

by Milan Matějček

v4.2.1

The Requires

The Development Requires

by Milan Matějček

dev-guzzle

The Requires

The Development Requires

by Milan Matějček

v4.2.0

The Requires

The Development Requires

by Milan Matějček

v4.1.0

The Requires

The Development Requires

by Milan Matějček

v4.0.7

The Requires

by Milan Matějček

v4.0.6

The Requires

by Milan Matějček

v4.0.5

The Requires

by Milan Matějček

v4.0.4

The Requires

by Milan Matějček

v4.0.3

The Requires

by Milan Matějček

v4.0.2

The Requires

by Milan Matějček

v4.0.1

The Requires

by Milan Matějček

v3.3.4

The Requires

by Milan Matějček

v3.3.3

The Requires

by Milan Matějček

v3.3.2