mscpatrykkosiba/currency-converter

使用fixer.io API的PHP全局货币转换器(包括比特币、银和金)

dev-master 2019-12-27 21:12 UTC

This package is auto-updated.

Last update: 2024-09-28 08:14:46 UTC


README

Scrutinizer Code Quality Build Status Code Intelligence Status

使用fixer.io API的PHP全局货币转换器(包括比特币、银和金)。

入门指南

在fixer.io注册以下载您的免费API密钥,并将其替换为YOUR_API_KEY。

<?php
	
	require __DIR__ .'/vendor/autoload.php';
	
	$value = new CConverter\Converter('YOUR_API_KEY');
	echo $value->cconv('EUR', 'USD'); // print for ex. 1.20303 (EUR -> USD)
	
	// set amount
	
	echo $value->cconv('EUR', 'USD', 10.20); // print for ex. 12.270906 (10.20 EUR -> USD)
	
	// set output digits number (with round up)
	
	echo $value->cconv('EUR', 'USD', 1, 4); // print for ex. 1.2030 (EUR -> USD)
	echo $value->cconv('EUR', 'USD', 1, 2); // print for ex. 1.20 (EUR -> USD)
	
	// convert by country short name
	
	echo $value->cconv('DE', 'USD'); // print for ex. 1.20303 (EUR -> USD)
	echo $value->cconv('DE', 'PL'); // print for ex. 4.20394 (EUR -> PLN)
	echo $value->cconv('HU', 'JP'); // print for ex. 400.30203 (HUF -> JPY)
	
	// convert for gold, sliver or bitcoin
	
	echo $value->cconv('EUR', 'BTC'); // print for ex. 0.00023 (EUR -> BTC) [BTC bitcoin]
	echo $value->cconv('USD', 'XAU'); // print for ex. 0.00223 (USD -> XAU) [XAU gold]
	echo $value->cconv('USD', 'XAU'); // print for ex. 0.00421 (USD -> XAG) [XAG silver]
	
	// convert currency using array
	
	$array = $value->cconv(array('EUR','PLN'), 'USD');
	var_dump($array); 
	/*
		var_dump($array) returns:
		EUR -> USD
		PLN -> USD
		..array
	*/
	$array = $value->cconv(array('EUR','PLN'), array('USD', 'GBP'));
	var_dump($array); 
	/*
		var_dump($array) returns:
		EUR -> USD
		EUR -> GBP
		PLN -> USD
		PLN -> GBP
		..array
	*/
	$array = $value->cconv('EUR', array('USD', 'GBP'));
	var_dump($array); 
	/*
		var_dump($array) returns:
		EUR -> USD
		EUR -> GBP
		..array
	*/
	

货币缓存

<?php
	
	require __DIR__ .'/vendor/autoload.php';
	
	$value = new CConverter\Converter('YOUR_API_KEY');
	$value->cache(true); // set this for enable caching, default cache time is 60 minutes
	echo $value->cconv('EUR', 'USD');
	
	// change cache time
	$value = new CConverter\Converter('YOUR_API_KEY');
	$value->cache(true, 10); // set this for enable caching and set 10 minutes cache file
	echo $value->cconv('EUR', 'USD');
	

要求

  • PHP版本5.5或更高
  • Fixer.io免费账户

用法

请查看“入门指南”部分。您可以组合上述示例。

<?php
	
	require __DIR__ .'/vendor/autoload.php';
	
	$value = new CConverter\Converter('YOUR_API_KEY');
	$array = $value->cconv(array('DE','EUR'), 'USD', 10.20304, 3);
	

安装

此库依赖于composer进行安装。有关composer的安装,请访问getcomposer.org。您可以下载.zip文件,将compile composer.json文件转换为创建vendor目录。

为何使用它

  • 使用fixer.io API可靠的汇率
  • 超过160种货币
  • 支持黄金、银和比特币汇率
  • 缓存汇率以避免多次连接到fixer.io
  • 通过国家简称(US、DE、PL、GB等)进行无货币代码的转换
  • 通过一个API引用转换多种货币

信息

在fixer.io上的免费账户允许您每月连接到API 1000次,并且每小时提供一次货币信息。为了有效地使用货币转换,请使用缓存选项。将缓存设置为60分钟,允许在不限制API访问时间的情况下有效使用服务。

作者

MSc Patryk Kosiba 请在linkedin上查看个人资料 (https://www.linkedin.com/in/patryk-kosiba/)

许可证

本项目采用MIT许可证。