Download the PHP package mattyeend/currency-exchange without Composer
On this page you can find all versions of the php package mattyeend/currency-exchange. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mattyeend/currency-exchange
More information about mattyeend/currency-exchange
Files in mattyeend/currency-exchange
Package currency-exchange
Short Description A Laravel package for currency exchange rates
License MIT
Informations about the package currency-exchange
Currency Exchange Laravel Package
The CurrencyExchange package provides a simple and efficient way to retrieve currency exchange rates and perform currency conversions in your Laravel applications. Integrates with the ExchangeRate API for reliable and up-to-date data.
Features
- Retrieve real-time exchange rates for any support currency.
- Perform currency conversions between two currencies.
- Easily configurable with a default base currency and API key.
- Includes a frontend UI for fetching rates and performing conversions.
- Lightweight and extensible, suitable for any Laravel application.
Installation
Step 1
Step 2
Publish the package configuration file to customise settings like the API key and base currency:
This will create a currencyexchange.php configuration file in your config directory.
Step 3
Add your ExchangeRate API key to your .env file:
Usage
Fetch Exchange Rates
You can fetch exchange rates programmatically using the CurrencyExchangeService:
Convert Currency
Perform a currency conversion between two currencies:
Routes
The package includes predefined routes for fetching exchange rates and performing conversions:
- View Exchange Rates:
GET
/currency-exchangeDisplays a basic UI for fetching and displaying rates. - Get Rates (API);
GET
/currency-exchange/ratesReturns exchange rates for a specific base currency. - Convert Currency (API):
POST
/currency-exchange/convertAcceptsamount,from, andtoparameters and returns the converted amount.
Views
A basic UI is included for quick usage. Visit /currency-exchange to view rates and use the conversion form.
To customise the view, edit the Blade template at:
resources/views/vendor/currencyexchange/index.blade.php
Testing
The package includes unit and feature tests. Run the tests using PHPUnit:
Configuration
The following configuration options are available in config/currencyexchange.php:
License
This package is open-source software licensed under the MIT license.
Contributing
Feel free to fork the repository and submit pull requests for improvements or new features!
All versions of currency-exchange with dependencies
illuminate/support Version ^10.0 || ^11.0 || ^12.0 || ^13.0
laravel/framework Version ^10.0 || ^11.0 || ^12.0 || ^13.0
guzzlehttp/guzzle Version ^7.0