Download the PHP package viaaurea/currency without Composer

On this page you can find all versions of the php package viaaurea/currency. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of viaaurea/currency

Informations about the package currency

Currency

Test Suite PHP from Packagist Powered by

Cross-currency money comparison and exchange tool. Framework agnostic.

💿 composer require viaaurea/currency

📖 Czech/Slovak readme version.

Use this package to do comparison arithmetic or aggregations on values in different currencies or exchange money in one currency to another.

💡\ This package is meant as a lightweight tool to exchange, compare and aggregate money value objects.\ For a fully fledged robust solution consider using Money for PHP.

Currency Service

CurrencyService is the main service class used for conversions and arithmetics. Its main dependency is an implementation of an exchange rate provider.\ During comparison operations or aggregations between money objects with different currencies exchange to one of the currencies must happen.\ The provider provides exchange rates for these conversions as well as for explicit conversions using CurrencyService::exchange method.

Currently only one implementation is delivered with this package - the StaticExchange, however, it is trivial to provide your own implementation according to your needs (database, third party API fetches etc.).

Configuration

The exchange rates are defined and passed to the StaticExchange class, which is then used by the CurrencyService. You can also provide your own exchange rate provider simply by implementing the ExchangeRateProviderInterface interface.

The rates are defined in relation to a reference/base/local currency.

For directly quoted reference currencies (USD, CAD, JPY, CZK, ...):

For indirectly quoted reference currencies (EUR, GBP, AUD, ...):

💡 You are not required to use a service container, in which case just assign the instance to a variable...

It is possible to specify amount of units with the rate. It can be used for currencies where the difference to the base currency is very high (certain African currencies, Bitcoin, etc.). To do that, pass in an array with the rate and amount:

Usage

See the examples at the beginning of this file above and see the source code of CurrencyService class for full list of available methods.

Fine-grain exchanges

The exchange method, as well as every comparison or aggregation method of CurrencyService accepts a variadic list of arguments that is passed down to the calls to underlying exchange rate provider. This can be leveraged to enable calculation of historic currency values, buy/sell/middle rates and so on.

Examples:

To use this functionality, a custom provider needs to be implemented, example:

Tip: use the ExchangeHelper class to easily implement a custom provider.

Nette DI extension

Contains an extension for the Nette framework. See the Czech/Slovak readme version.

Contributions

... are welcome.

All versions of currency with dependencies

PHP Build Version
Package Version
Requires php Version ^8 || ^7.4
ext-json Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package viaaurea/currency contains the following files

Loading the files please wait ....