README

一个将货币从一种转换为另一种的Codeigniter库

背景

在您的网站上，您经常需要将价格从一种货币转换为另一种货币。这个库可以将您的价格转换为世界上任何货币。

它与fixer.io api一起工作，如果您想的话，还会在网站数据库中存储货币汇率。用户可以配置每小时更新汇率的时间，如果用户不想使用数据库，则汇率每次都使用当前的转换率进行更新。

如果您已设置为使用数据库，例如，用户设置为每小时更新一次汇率，则该库第一次从fixer.io获取货币转换率，将其存储在数据库中，然后在下一个小时内，如果存在，则从数据库中获取转换率。这样就可以减少转换请求的时间，并且每小时都会更新汇率。

如果您没有设置为使用数据库，那么每次调用库时，它都会向fixer.io api发送请求并获取实际的转换率。如果您没有太多请求，这是一个很好的解决方案。相反，如果您有很多转换请求，则最好使用数据库配置。

需求

• CodeIgniter 2.x或3.x
• PHP 5.3或更高版本

安装

您可以使用composer安装此包

composer require alessandrominoccheri/codeigniter-currency-converter

或者，将应用/libraries/CurrencyConverter.php文件拖放到您的应用目录中。通过在您的应用/config/autoload.php中使用以下内容加载它

$autoload['libraries'] = array('database', 'CurrencyConverter');

或者，在您的模型中，您可以使用

$this->CurrencyConverter = new CurrencyConverter();

如果需要使用数据库保存转换，则必须有一个有效的数据库连接。

用法

要从模型/控制器中转换价格，您可以发出如下请求

$result = $this->CurrencyConverter->convert('GBP', 'EUR', '2000.00', true, 1);

要获取货币代码列表，请查看此处

可用货币代码列表

参数

检索转换价格的功能声明为

function convert($from_Currency, $to_Currency, $amount, $save_into_db = 1, $hour_difference = 1)

• fromCurrency：是实际价格的货币（例如：EUR，GBP）
• toCurrency：是要转换价格的货币（例如：EUR，GBP）
• amount：是要转换的价格（例如：200，20）
• saveIntoDb：是配置使用数据库或不使用的变量，如果不使用hour_difference参数将被忽略
• hourDifference：是更新货币转换的小时差。例如，如果您已设置为每小时更新一次汇率，则该库第一次从fixer.io获取货币转换率，将其存储在数据库中，然后在下一个小时内，如果存在，则从数据库中获取转换率。

API密钥

要使用此库，您需要在配置中添加您的API密钥。要获取您的API密钥，请访问此网站并生成它。

生成您的API密钥

许可

MIT许可证（MIT）

版权所有 (c) 2014 Alessandro Minoccheri

特此授予任何获得此软件及其相关文档副本（以下简称“软件”）的人免费使用该软件的权利，不受限制，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利，并允许获得该软件的人使用该软件，受以下条件约束

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“原样”提供，不提供任何形式的保证，无论是明确的还是隐含的，包括但不限于适销性、特定用途的适用性和非侵权性。在任何情况下，作者或版权持有人不应对任何索赔、损害或其他责任负责，无论基于合同、侵权或其他原因，无论该索赔、损害或其他责任源于、因之而起或与之有关软件或对软件的使用或其他方式。