README

Currency Converter 是一个简单易用的 Laravel 货币转换包。

入门指南

通过 composer 安装货币转换器。注意：如果您还没有 composer，可以通过访问 https://getcomposer.org.cn 来安装。

步骤 1. 安装包

composer require amkas/currency-converter

步骤 2. 注册货币转换器服务提供者（可选）

在 bootstrap/providers.php 文件中，您可以添加以下行

 \Amkas\CurrencyConverter\ConversionServiceProvider::class,

步骤 3. 发布资源

运行以下命令来发布资源。

 php artisan vendor:publish --tag=amkas-currency-converter

或者

php artisan vendor:publish --provider="Amkas\CurrencyConverter\ConversionServiceProvider"

该命令将复制以下三个文件

Copying file [amkas\currency-converter\src\Models\CurrencyRate.php] to [app\Models\CurrencyRate.php]  DONE
Copying file [amkas\currency-converter\src\config\currency_converter.php] to [config\currency_converter.php]  DONE
Copying directory [amkas\currency-converter\src\database\migrations] to [database\migrations]  DONE

所以有三个文件

1. 货币汇率迁移
2. 货币汇率模型
3. config/currency-converter.php

之后，您需要运行以下迁移命令将货币汇率表迁移到数据库中

 php artisan migrate

然后您可以在配置文件中设置默认货币，如下所示

'default_currency' => 'USD',

以及其他配置设置。

之后，您可以创建 CRUD 以将货币汇率保存到数据库中

用法

在控制器中包含货币外观并按以下方式调用

  use Amkas\CurrencyConverter\Facades\Currency;
  
  $convertedAmount = Currency::convertAmount(10, 'EUR');

如果您想使用助手函数，请使用以下。

  $convertedAmount = convertAmount(10, 'EUR');

如果您想使用货币外观将一种货币转换为另一种货币，请按以下方式调用链式函数

    $convertedAmount = Currency::amount(10)
        ->from('EUR')
        ->to("USD")
        ->convert();

使用助手函数可以按以下方式调用

    $convertedAmount = amount(10)
        ->from("EUR")
        ->to("USD")
        ->convert();

注意：由于此货币转换器已实现缓存以避免在每次调用货币转换函数时进行数据库查询，因此每次通过货币汇率模型添加新汇率时，缓存将自动重置。

然而，您可以通过运行以下命令来重置特定的缓存

php artisan converter:reset-cache