Installation

Installation#

To install Peso, first select the desired integration lib, then the desired service lib, like so:

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

In this example

  • peso/peso is a simple wrapper over Peso services for standalone use

  • peso/ecb-service is a service provider for the European Central Bank

  • ECB service dependencies, same for all HTTP integrations:

    • php-http/discovery is a HTTP client autoconfigure package. It is not required, you can configure the client manually.

    • guzzlehttp/guzzle is a HTTP client known to php-http/discovery. Any client supporting PSR-18 would do.

    • symfony/cache a cache library if you need caching. (recommended)

Version notes:

  • Alpha series: 0.1.x, … 0.8.x. Unstable to use

  • Beta series: 0.9.x, 0.10.x, … Stable to use but interfaces may rapidly change

  • Release series: 1.x. Expected in July or August 2025

Available integrations:

Available services:

peso/ecb-service

European Central Bank

peso/cnb-service

Czech National Bank

peso/fixer-service

Fixer

peso/openexchangerates-service

Open Exchange Rates

Available interoperability connectors:

peso/peso-exchanger-interop

Exchanger and Swap