PHP项目数字冰岛克朗与eISK

本文目录导读：

1. 数据类型：使用整数（分/奥拉）或 BC Math
2. 货币格式化
3. 汇率处理：ISK ↔ eISK
4. 完整的 Money 类示例（推荐）
5. 数据库存储建议
6. 常见陷阱与注意事项
7. 总结代码片段

在 PHP 项目中处理冰岛克朗 (ISK) 与 电子冰岛克朗 (eISK) 时，主要涉及以下几个核心问题：

1. 数据类型与精度（避免浮点数误差）
2. 货币格式与符号
3. 汇率转换（仅当 eISK 与 ISK 存在浮动汇率时）
4. 金额运算（加减乘除及比较）

以下是针对 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';

---

常见陷阱与注意事项

1. 余额显示：前端显示时，eISK 建议用不同颜色或标识区分，避免用户混淆。
2. 精度控制：任何涉及除法的地方（如计算手续费），必须使用 bcmath 的 bcdiv 函数。
3. 国际支付：如果用户切换为美元或欧元，必须通过实时汇率 API（如 Fixer.io）计算，且先转换为 ISK 基础量。
4. 税务相关：冰岛法律对加密货币（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 集成），请告诉我！