README

一个简单的Laravel包，用于从意大利银行检索信息。

安装

您可以通过Composer安装此包

composer require offline-agency/laravel-bank-of-italy

您需要使用以下命令发布配置文件

php artisan vendor:publish --provider="OfflineAgency\LaravelBankOfItaly\LaravelBankOfItalyServiceProvider"

用法

目前，该包提供了一种获取货币之间汇率的方法。

基本

$exchange_rate = new ExchangeRate();
$exchange_rates = $exchange_rate->getExchangeRates();

foreach ($exchange_rates->getItems() as $exchange_rate) {
    dd($exchange_rate); 
    /*
     OfflineAgency\LaravelBankOfItaly\Entities\ExchangeRate\ExchangeRate {
        +currency: "Dollaro USA"
        +currencyIsoCode: "USD"
        +currencyUicCode: "001"
        +rate: "1.0724"
        +rateConvention: "Quantità di valuta estera per 1 Euro"
        +referenceDate: "Y-m-d"
     }
     */
}

在这个例子中，方法getExchangeRates()返回一个OfflineAgency\LaravelBankOfItaly\Entities\ExchangeRate\ExchangeRates实例。您可以使用getItems()方法检索一个ExchangeRate对象数组。每个ExchangeRate对象包含以下属性

• currency: 货币名称（例如，“美元”）
• currencyIsoCode: 货币的ISO代码（例如，“USD”）
• currencyUicCode: 货币的UIC代码（例如，“001”）
• rate: 汇率（例如，“1.0724”）
• rateConvention: 汇率惯例（例如，“每1欧元的外币数量”）
• referenceDate: 汇率的参考日期（格式：Y-m-d）

自定义查询参数

您还可以提供自定义查询参数以筛选结果。以下是可以指定的字段

$exchange_rate = new ExchangeRate();
$response = $exchange_rate->getExchangeRates([
    'lang' => 'en', // Default: it
    'baseCurrencyIsoCode' => 'EUR', // Default: USD
    'currencyIsoCode' => 'ITL', // Default: EUR (accepted values: EUR, USD, ITL)
    'startDate' => '01-01-2000', // Default: Carbon::now()->subYear() (format: Y-m-d)
    'endDate' => '01-01-2000' // Default: Carbon::now() (format: Y-m-d)
]);

错误处理

• 如果存在验证错误，该方法返回一个Illuminate\Support\MessageBag实例。
• 如果在API调用过程中发生错误，该方法返回一个包含错误属性的OfflineAgency\LaravelBankOfItaly\Entities\Error实例。

贡献

请参阅CONTRIBUTING以获取详细信息。

安全性

如果您发现任何与安全相关的问题，请通过support@offlineagency.com发送电子邮件，而不是使用问题跟踪器。

鸣谢

• Offline Agency
• Giacomo Fabbian
• Nicolas Sanavia
• 所有贡献者

关于我们

Offline Agency是一家位于意大利帕多瓦的网站设计公司。您可以在我们的网站上找到我们项目的概述在这里。

许可证

MIT许可证（MIT）。有关更多信息，请参阅许可证文件。