PHPackages flexmind-software/currency-rate - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Database & ORM](/categories/database) 4. / 5. flexmind-software/currency-rate ActiveLibrary[Database & ORM](/categories/database) flexmind-software/currency-rate =============================== Library download currency rate and save in database, It's designed to be extended by any available data source. 0.1.1(4y ago)2151MITPHPPHP ^7.4CI passing Since Sep 14Pushed 10mo ago1 watchersCompare [ Source](https://github.com/flexmind-software/currency-rate)[ Packagist](https://packagist.org/packages/flexmind-software/currency-rate)[ Docs](https://github.com/flexmind-software/currency-rate)[ GitHub Sponsors](https://github.com/flexmind-software)[ RSS](/packages/flexmind-software-currency-rate/feed)WikiDiscussions main Synced 3w ago READMEChangelogDependencies (8)Versions (14)Used By (0) Currency Rate Downloader ======================== [](#currency-rate-downloader) [![Laravel Version Support](https://camo.githubusercontent.com/1aadb0b808f86dcf5347c367776fb08e0163ba81fc0874c3473cd6a41a00067b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d382e782d6f72616e67653f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/1aadb0b808f86dcf5347c367776fb08e0163ba81fc0874c3473cd6a41a00067b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d382e782d6f72616e67653f7374796c653d666c61742d737175617265)[![Packagist PHP Version Support](https://camo.githubusercontent.com/36b9cb41a8426f563182a321df9b0041077756a2f33e6026795d97709f685e2a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f666c65786d696e642d736f6674776172652f63757272656e63792d726174653f6c6162656c3d504850267374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/36b9cb41a8426f563182a321df9b0041077756a2f33e6026795d97709f685e2a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f666c65786d696e642d736f6674776172652f63757272656e63792d726174653f6c6162656c3d504850267374796c653d666c61742d737175617265)[![Latest Version on Packagist](https://camo.githubusercontent.com/c4d35aa835de2f7e9af6b709227ed7a899e2c92dd4795095e8f0be835cd5b6f4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666c65786d696e642d736f6674776172652f63757272656e63792d726174652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/flexmind-software/currency-rate)[![GitHub Tests Action Status](https://camo.githubusercontent.com/524fbae7b31f9241d64774119f7518d7c3eb0a7e05dc31f764c9e0c962970b3a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f666c65786d696e642d736f6674776172652f63757272656e63792d726174652f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/flexmind-software/currency-rate/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/cb64ce2616f858153f01916323289c01bf89e7da5e2df1e8bcc6380fad5ea775/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f666c65786d696e642d736f6674776172652f63757272656e63792d726174652f436865636b253230262532306669782532307374796c696e673f6c6162656c3d636f64652532307374796c65)](https://github.com/flexmind-software/currency-rate/actions?query=workflow%3A%22Check+%26+fix+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/d1e5cb8ee2ca16e2793fd90bad3da15792dff7d8f53b488c1876ec4dcbc5341e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666c65786d696e642d736f6674776172652f63757272656e63792d726174652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/flexmind-software/currency-rate) Installation ------------ [](#installation) You can install the package via composer: ``` composer require flexmind-software/currency-rate ``` You can publish and run the migrations with: ``` php artisan vendor:publish --provider="FlexMindSoftware\CurrencyRate\CurrencyRateProvider" --tag="currency-rate-migrations" php artisan migrate ``` You can publish the config file with: ``` php artisan vendor:publish --provider="FlexMindSoftware\CurrencyRate\CurrencyRateProvider" --tag="currency-rate-config" ``` This is the contents of the published config file: ``` return [ 'driver' => env('FLEXMIND_CURRENCY_RATE_DRIVER', 'european-central-bank'), 'drivers' => [ 'albania', 'armenia', 'australia', 'azerbaijan', 'bceao', 'belarus', 'bosnia-and-herzegovina', 'botswana', 'bulgaria', 'canada', 'china', 'croatia', 'czech-republic', 'denmark', 'england', 'european-central-bank', 'fiji', 'georgia', 'hungary', 'iceland', 'israel', 'macedonia', 'moldavia', 'norway', 'poland', 'romania', 'russia', 'serbia', 'sweden', 'switzerland', 'turkey', 'ukraine', ], 'table-name' => env('FLEXMIND_CURRENCY_RATE_TABLENAME', 'currency_rates'), 'cache-ttl' => env('FLEXMIND_CURRENCY_RATE_CACHE_TTL', 3600), ]; ``` The `drivers` array defines which currency rate providers are available when running the command with `--driver=all`. Add or remove entries from this list to customise the drivers used in your application. See [config/currency-rate.php](config/currency-rate.php) for additional configuration options, including the cache TTL for HTTP requests. ### Available Drivers [](#available-drivers) Country / SourceDriverAlbania`albania`Armenia`armenia`Australia`australia`Azerbaijan`azerbaijan`BCEAO`bceao`Belarus`belarus`Bosnia and Herzegovina`bosnia-and-herzegovina`Botswana`botswana`Bulgaria`bulgaria`Canada`canada`China`china`Croatia`croatia`Czech Republic`czech-republic`Denmark`denmark`England`england`European Central Bank`european-central-bank`Fiji`fiji`Georgia`georgia`Hungary`hungary`Iceland`iceland`Israel`israel`Macedonia`macedonia`Moldavia`moldavia`Norway`norway`Poland`poland`Romania`romania`Russia`russia`Serbia`serbia`Sweden`sweden`Switzerland`switzerland`Turkey`turkey`Ukraine`ukraine`Usage ----- [](#usage) ``` php artisan flexmind:currency-rate [options] [--] [] Arguments: date Date to download currency rate, if empty is today Options: --queue[=QUEUE] Queue name, if set "none" cmd run without add job to queue [default: "none"] --driver[=DRIVER] Driver to download rate [default: "all"] ``` Events ------ [](#events) The `CurrencyRate::saveIn` method dispatches a `CurrencyRateSaved` event once rates are persisted. Consumers may listen for this event to trigger downstream actions: ``` use FlexMindSoftware\CurrencyRate\Events\CurrencyRateSaved; use Illuminate\Support\Facades\Event; Event::listen(CurrencyRateSaved::class, function (CurrencyRateSaved $event) { // $event->rates contains the saved records }); ### Examples Run for today's rates using all configured drivers: ```bash php artisan flexmind:currency-rate ``` Fetch rates for a specific date: ``` php artisan flexmind:currency-rate 2023-09-15 ``` Use a specific driver: ``` php artisan flexmind:currency-rate --driver=canada ``` Dispatch the job to a queue: ``` php artisan flexmind:currency-rate --queue=default ``` Execute immediately without queueing: ``` php artisan flexmind:currency-rate --queue=none ``` Testing ------- [](#testing) ``` composer test ``` Sources ------- [](#sources) Country name Central Bank Driver name Europe [European Central Bank](https://ecb.europa.eu) european-central-bank Albania [Bankës së Shqipërisë](https://www.bankofalbania.org/home) albania Armenia [Hayastani Hanrapetut’yan Kentronakan Bank](https://www.cba.am/en/sitepages/default.aspx) armenia Azerbaijan [Azərbaycan Mərkəzi Bankı](https://www.cbar.az) azerbaijan Belarus [Нацыянальны банк Рэспублікі Беларусь](https://www.nbrb.by/engl/) belarus Bosnia and Herzegovina [Централна банка Босне и Херцеговине](https://www.cbbh.ba/?lang=en) bosnia-and-herzegovina Bulgaria [Bŭlgarska narodna banka](https://www.bnb.bg/?toLang=_EN) bulgaria Croatia [Hrvatska Narodna Banka](https://www.hnb.hr/home) croatia Czech Republic [Česká národní banka](https://www.cnb.cz/en/index.html) czech-republic Danmark [Danmarks Nationalbanks](https://www.nationalbanken.dk) denmark Georgia [Sakartvelos Erovnuli Bank’i](https://www.nbg.gov.ge) georgia United Kingdom [Bank of England](https://www.bankofengland.co.uk/) england Hungary [Magyar Nemzeti Bank](https://www.mnb.hu/en/) hungary Iceland [Seðlabanki Íslands](https://cb.is) iceland Macedonia [Narodna Banka na Republika Severna Makedonija](https://www.nbrm.mk/) macedonia Moldavia [Banca Naţională a Moldovei](https://www.bnm.md/) moldavia Norway [Norges Bank](https://www.norges-bank.no/en/) norway Poland [Narodowy Bank Polski](https://www.nbp.pl/) poland Russia [Tsentral'nyy bank Rossiyskoy Federatsii](https://cbr.ru/) russia Romania [Banca Națională a României](https://www.bnro.ro/) romania Serbia [Narodna banka Srbije](https://www.nbs.rs/) serbia Switzerland [Banca naziunala svizra](https://www.snb.ch/) switzerland Sweden [Sveriges Riksbank](https://www.riksbank.se/en-gb/) sweden Turkey [Türkiye Cumhuriyet Merkez Bankası](https://www.tcmb.gov.tr/) turkey Ukraine [Natsionalʹnyy bank Ukrayiny](https://www.bank.gov.ua/) ukraine Africa Benin [Central Bank of West African States (BCEAO)](https://www.bceao.int) bceao Botswana [Bank of Botswana](https://www.bankofbotswana.bw) botswana Burkina Faso [Central Bank of West African States (BCEAO)](https://www.bceao.int) bceao Guinea-Bissau [Central Bank of West African States (BCEAO)](https://www.bceao.int) bceao Ivory Coast [Central Bank of West African States (BCEAO)](https://www.bceao.int) bceao Mali [Central Bank of West African States (BCEAO)](https://www.bceao.int) bceao Niger [Central Bank of West African States (BCEAO)](https://www.bceao.int) bceao Senegal [Central Bank of West African States (BCEAO)](https://www.bceao.int) bceao Togo [Central Bank of West African States (BCEAO)](https://www.bceao.int) bceao Asia China [CFETS - China Foreign Exchange Trade System](http://www.chinamoney.com.cn/english/bmkcpr/) china Israel [בנק ישראל](https://www.boi.org.il/) israel North America Canada [Banqueu du Canada](https://www.bankofcanada.ca/) canada Oceania Australia [Reserve Bank of Australia](https://www.rba.gov.au/) australia Fiji [Reserve Bank of Fiji](https://www.rbf.gov.fj/) fiji Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. ### Adding new locales [](#adding-new-locales) Translations for driver descriptions live in `resources/langs/{locale}/description.php`. To contribute a new locale: 1. Create a new directory for the locale under `resources/langs` (for example `es` for Spanish). 2. Copy `resources/langs/en/description.php` into that directory and translate the strings. 3. Submit a pull request with the new translation file. Credits ------- [](#credits) - [Krzysztof Bielecki](https://github.com/qwerkon) - [All Contributors](https://github.com/flexmind-software/currency-rate/contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 29 — LowBetter than 57% of packages Maintenance39 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community10 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 66.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~1 days Total 11 Last Release 1743d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/1d1309f681c1a04cf5a71e00b95223561e6edcce9d9df441e27218f8a5c695ad?d=identicon)[systemy-flexmind](/maintainers/systemy-flexmind) --- Top Contributors [![qwerkon](https://avatars.githubusercontent.com/u/5518662?v=4)](https://github.com/qwerkon "qwerkon (91 commits)")[![systemy-flexmind](https://avatars.githubusercontent.com/u/51311340?v=4)](https://github.com/systemy-flexmind "systemy-flexmind (45 commits)") --- Tags currency-convertercurrency-exchange-ratescurrency-rateflexmindlaravellaravel-packagemysqlphppostgresqlphplaravelmysqlmongocurrency-convertercurrency ratecurrency-exchangecurrency ratespostresqlflexmindpachagesforeign exchange rates ### Code Quality TestsPHPUnit Static AnalysisPsalm Type Coverage Yes ### Embed Badge ![Health badge](/badges/flexmind-software-currency-rate/health.svg) ``` [![Health](https://phpackages.com/badges/flexmind-software-currency-rate/health.svg)](https://phpackages.com/packages/flexmind-software-currency-rate) ``` ### Alternatives [illuminate/database The Illuminate Database package. 2.8k54.9M11.5k](/packages/illuminate-database)[psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[spatie/laravel-health Monitor the health of a Laravel application 87512.0M162](/packages/spatie-laravel-health)[harris21/laravel-fuse Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures. 44855.7k](/packages/harris21-laravel-fuse)[laravel/ai The official AI SDK for Laravel. 1.0k3.2M189](/packages/laravel-ai)[moonshine/moonshine Laravel administration panel 1.3k253.1k81](/packages/moonshine-moonshine) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)