Fixer

Contents

Fixer#

This service retrieves the data from the Fixer.io service.

Installation#

Install the service:

composer require peso/fixer-service

Install the service with all recommended dependencies:

composer require peso/fixer-service php-http/discovery guzzlehttp/guzzle symfony/cache

Usage#

Note

Free key allows you to retrieve only Euro as a base currency. To be able to convert other currencies back to EUR you can wrap it with ReversibleService.

Example:

<?php

use Peso\Core\Services\ReversibleService;
use Peso\Peso\CurrencyConverter;
use Peso\Services\Fixer\AccessKeyType;
use Peso\Services\FixerService;
use Symfony\Component\Cache\Adapter\FilesystemAdapter;
use Symfony\Component\Cache\Psr16Cache;

$cache = new Psr16Cache(new FilesystemAdapter(directory: __DIR__ . '/cache'));
$service = new FixerService('...', AccessKeyType::Free, cache: $cache);
$converter = new CurrencyConverter($service);

// 14419.61 as of 2025-06-20
echo $converter->convert('12500', 'EUR', 'USD', 2), PHP_EOL;

$reversibleService = new ReversibleService($service);
$converter = new CurrencyConverter($reversibleService);

// 10835.94 as of 2025-06-20
echo $converter->convert('12500', 'USD', 'EUR', 2), PHP_EOL;

// you can optionally limit the retrieved symbols
$cache = new Psr16Cache(new FilesystemAdapter(directory: __DIR__ . '/cache'));
$service = new FixerService('...', AccessKeyType::Free, [
    'EUR', 'USD', 'JPY', 'CHF'
], $cache);
$converter = new CurrencyConverter($service);

// ...
Contents