本文目录导读：
在 PHP 项目中处理冰岛克朗 (ISK) 与 电子冰岛克朗 (eISK) 时，主要涉及以下几个核心问题：
- 数据类型与精度（避免浮点数误差）
- 货币格式与符号
- 汇率转换（仅当 eISK 与 ISK 存在浮动汇率时）
- 金额运算（加减乘除及比较）
以下是针对 PHP 项目的详细实现方案。
数据类型：使用整数（分/奥拉）或 BC Math
绝对不要使用 float或 double！
- ISK 的辅币单位：1 ISK = 100 奥拉（aurar），由于冰岛已取消流通奥拉硬币，但电子支付中仍可存在小数。
- 最佳实践：以分（奥拉）为单位存储为整数。
12345代表 123.45 ISK。
如果要处理高精度小数（比如汇率运算），必须使用 PHP 的 BC Math 扩展。
<?php // 使用整数存储（推荐） $amountInCents = 12345; // 代表 123.45 ISK // 或者使用 BC Math 字符串运算 $a = '123.45'; $b = '67.89'; $sum = bcadd($a, $b, 2); // 结果为 '191.34'
货币格式化
使用 PHP 内置的 NumberFormatter（intl 扩展）进行本地化格式化。
<?php
function formatISK($amount, bool $includeSymbol = true, string $locale = 'is_IS'): string {
$fmt = new NumberFormatter($locale, NumberFormatter::CURRENCY);
// eISK 通常没有独立符号，可复用 kr 或自定义
return $fmt->formatCurrency($amount, 'ISK');
}
// 示例
echo formatISK(12345.67); // 输出: 12.345,67 kr (取决于 locale)
注意：冰岛语 locale is_IS 的格式：
- 千位分隔符：（点）
- 小数分隔符：（逗号）
- 货币符号：
kr放在数字后面。
区分 eISK 显示：如果希望明确显示 eISK，可以自定义替换符号：
function formatEISK($amount): string {
$formatted = formatISK($amount);
// 将 kr 替换为 eISK 或自定义符号
return str_replace(' kr', ' eISK', $formatted);
}
汇率处理：ISK ↔ eISK
eISK 通常是与 ISK 1:1 锚定的数字代币（类似 USDT 与 USD）。 但需要注意：部分加密货币交易所的 eISK 可能存在市场波动。
方案 A：固定汇率（1:1） 直接复制 ISK 金额，无需转换。
function iskToEisk(float|string $iskAmount): string {
// 直接返回相同值，保持精度
return (string) $iskAmount;
}
方案 B：动态汇率（从 API 获取）
<?php
class CurrencyConverter {
private float $rate;
public function __construct(float $rate) {
$this->rate = $rate;
}
public function iskToEisk(string|int|float $isk): string {
// 使用 bcmath 避免浮点误差
return bcmul((string)$isk, (string)$this->rate, 6);
}
public function eiskToIsk(string|int|float $eisk): string {
return bcdiv((string)$eisk, (string)$this->rate, 2);
}
}
// 使用示例（假设汇率 1 eISK = 0.98 ISK）
$converter = new CurrencyConverter(0.98);
echo $converter->iskToEisk('100.00'); // 输出: 98.000000
echo $converter->eiskToIsk('100.00'); // 输出: 102.04
完整的 Money 类示例（推荐）
更健壮的方式是封装一个 Money 类，专门处理 ISK/eISK：
<?php
class ISKMoney {
private int $cents; // 以奥拉（分）为单位
public function __construct(int $cents) {
$this->cents = $cents;
}
public static function fromDecimal(float $amount): self {
return new self((int) round($amount * 100));
}
public function toEisk(): self {
// 如果是 1:1 锚定，直接返回新实例
// 如果有汇率，则在此处计算
return new self($this->cents);
}
public function format(): string {
$value = $this->cents / 100;
return number_format($value, 2, ',', '.') . ' kr';
}
public function formatEisk(): string {
return str_replace(' kr', ' eISK', $this->format());
}
}
数据库存储建议
| 字段 | 类型 | 说明 |
|---|---|---|
amount |
INT |
存储为奥拉/分（如 12345） |
currency |
VARCHAR(4) |
存储 ISK 或 EISK |
rate |
DECIMAL(12,8) |
存储汇率，仅用于非锚定场景 |
查询示例：
-- 获取总金额（单位：克朗） SELECT SUM(amount) / 100 AS total_in_isk FROM transactions WHERE currency = 'ISK';
常见陷阱与注意事项
- 余额显示：前端显示时，eISK 建议用不同颜色或标识区分，避免用户混淆。
- 精度控制：任何涉及除法的地方（如计算手续费），必须使用
bcmath的bcdiv函数。 - 国际支付：如果用户切换为美元或欧元，必须通过实时汇率 API（如 Fixer.io）计算，且先转换为 ISK 基础量。
- 税务相关：冰岛法律对加密货币（eISK）的交易可能有额外的 CGT（资本利得税）报告要求，需确认业务需求。
总结代码片段
<?php
// 1. 格式化显示
echo formatISK(1499.99); // 1.499,99 kr
// 2. 金额运算（BC Math）
$price = '1000.00';
$tax = bcdiv($price, '100', 2); // 10.00 (1% 手续费)
$total = bcadd($price, $tax, 2); // 1010.00
// 3. 数据库操作
$stmt = $pdo->prepare("INSERT INTO payments (user_id, amount_cents, currency) VALUES (?, ?, ?)");
$stmt->execute([$userId, 12345, 'ISK']);
如果你需要更具体的场景（如 WooCommerce 插件、Laravel 集成），请告诉我！
