Download the PHP package xdemonme/currency without Composer
On this page you can find all versions of the php package xdemonme/currency. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download xdemonme/currency
More information about xdemonme/currency
Files in xdemonme/currency
Package currency
Short Description A PHP library for current and historical currency exchange rates & crypto exchange rates based on the free API provided by exchangerate.host
License MIT
FAQ
Example:
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 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.
Informations about the package currency
Currency
This package supports exchangerate.host API keys.
Currency is a simple PHP library for current and historical currency exchange rates & crypto exchange rates. based on the free API exchangerate.host!
Requirements
- PHP >= 7.2
- guzzlehttp >= 6.0
Installation
Usage
1. Currency Conversion
To convert from one currency to another you may chain the methods:
This will return the converted amount or null on failure.
The amount to be converted is default to 1, you may specify the amount:
Available Methods
-
Convert currency using historical exchange rates
YYYY-MM-DD: -
Round the converted amount to decimal places:
- You may also switch data source between forex
default, bank view or crypto currencies:
2. Live (latest) Rates
Note: This method is DEPRECATED
To get latest rates you may chain the methods:
This will return an array of all available currencies or null on failure.
Available Methods
- Just like currency conversion you may chain any of the available methods:
3. Historical Rates
Historical rates are available for most currencies all the way back to the year of 1999.
Same as latest rates you may chain any of the available methods:
4. Timeframe (timeseries) Rates
Timeframe (timeseries) are for daily historical rates between two dates of your choice, with a maximum time frame of 365 days.
This will return an array or null on failure.
5. Change (fluctuations)
Retrieve information about how currencies fluctuate on a day-to-day basis, with a maximum time frame of 365 days.
This will return an array or null on failure.
Throwing Exceptions
The default behavior is to return null for errors that occur during the request (connection timeout, DNS errors, client or server error status code, missing API success parameter, etc.).
If you would like to throw an exception instead, you may use the throw method, The throw method returns the currency instance, allowing you to chain other methods:
If you would like to perform some additional logic before the exception is thrown, you may pass a closure to the throw method:
Using HTTPS
If your Subscription Plan supports HTTPS Encryption, you may use HTTPS protocol instead of HTTP using useHTTPS method:
Other Methods
-
You may use the
withoutVerifyingmethod to indicate that TLS certificates should not be verified when sending the request: -
You may specify additional Guzzle request options using the
withOptionsmethod. ThewithOptionsmethod accepts an array of key / value pairs: - The
whenmethod will execute the given callback when the first argument given to the method evaluates to true:
License
The MIT License (MIT). Please see LICENSE for more information.
