PHP项目数字加纳塞地与eGHS

wen PHP项目 2026-07-17 175

本文目录导读：

PHP项目数字加纳塞地与eGHS

基本货币格式显示
数字与货币转换（金额处理）
汇率处理（GHS ↔ eGHS）
货币检测与统一处理
数据库存储建议
货币数字转大写（加纳塞地专用）
完整使用示例
关键注意事项

在PHP项目中处理“数字加纳塞地（GHS）”和“电子加纳塞地（eGHS）”涉及货币单位、格式化和可能的汇率转换，以下是关键实现方法：

基本货币格式显示

class GhanaCediFormatter {
    // 格式化为加纳塞地显示
    public static function formatGHS($amount) {
        return 'GH¢ ' . number_format($amount, 2);
    }
    // 格式化 eGHS（通常同值但可标记）
    public static function formatEGHS($amount) {
        return 'eGH¢ ' . number_format($amount, 2);
    }
}
// 使用示例
echo GhanaCediFormatter::formatGHS(1500.50); // GH¢ 1,500.50
echo GhanaCediFormatter::formatEGHS(500.00); // eGH¢ 500.00

数字与货币转换（金额处理）

class GhanaCediConverter {
    // 数字转加纳塞地字符串
    public static function numberToGHS($number) {
        $formatted = number_format($number, 2, '.', ',');
        return "GH¢ {$formatted}";
    }
    // 解析用户输入的金额（处理前缀/后缀）
    public static function parseAmount($input) {
        // 移除非数字字符（保留小数点和负号）
        $cleaned = preg_replace('/[^0-9.-]/', '', $input);
        return floatval($cleaned);
    }
    // 金额转分（最小单位）
    public static function toPesewas($amount) {
        return intval(round($amount * 100));
    }
    // 从分转回塞地
    public static function fromPesewas($pesewas) {
        return $pesewas / 100;
    }
}

汇率处理（GHS ↔ eGHS）

class EGHSCurrency {
    private $exchangeRate; // 1 GHS = ? eGHS
    public function __construct($rate = 1.0) {
        $this->exchangeRate = $rate;
    }
    // GHS 转 eGHS
    public function convertToEGHS($ghsAmount) {
        return $ghsAmount * $this->exchangeRate;
    }
    // eGHS 转 GHS
    public function convertToGHS($eghsAmount) {
        return $eghsAmount / $this->exchangeRate;
    }
    // 获取最新汇率（示例API）
    public function fetchLiveRate() {
        // 实际项目中调用银行或央行API
        // $response = file_get_contents('https://api.bog.gov.gh/rates');
        // return json_decode($response)->rate;
        return 1.0; // 当前假设1:1
    }
}

货币检测与统一处理

class CurrencyDetector {
    public static function detectAndConvert($input) {
        // 检测字符串中的货币类型
        if (preg_match('/^eGH[¢ C]/i', $input)) {
            $amount = GhanaCediConverter::parseAmount($input);
            return ['type' => 'eGHS', 'amount' => $amount];
        } else {
            $amount = GhanaCediConverter::parseAmount($input);
            return ['type' => 'GHS', 'amount' => $amount];
        }
    }
    // 统一转换为GHS（用于计算）
    public static function normalizeToGHS($input, $eghsRate = 1.0) {
        $detected = self::detectAndConvert($input);
        if ($detected['type'] === 'eGHS') {
            return $detected['amount'] / $eghsRate;
        }
        return $detected['amount'];
    }
}

数据库存储建议

// 表结构建议
CREATE TABLE transactions (
    id INT AUTO_INCREMENT PRIMARY KEY,
    amount_ghs DECIMAL(15,2) NOT NULL,  -- 统一以GHS存储
    amount_eghs DECIMAL(15,2) DEFAULT NULL,
    currency_type ENUM('GHS', 'eGHS') DEFAULT 'GHS',
    rate_applied DECIMAL(10,6) DEFAULT 1.000000,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
// PHP插入示例
$stmt = $pdo->prepare("INSERT INTO transactions 
    (amount_ghs, amount_eghs, currency_type, rate_applied) 
    VALUES (?, ?, ?, ?)");
// 如果用户输入的是eGHS
$eghsAmount = 200.00;
$rate = 1.05; // 假设汇率
$ghsAmount = $eghsAmount / $rate;
$stmt->execute([$ghsAmount, $eghsAmount, 'eGHS', $rate]);

货币数字转大写（加纳塞地专用）

class GhanaCediToWords {
    public static function convert($number) {
        $pesewas = round(($number - floor($number)) * 100);
        $cedis = floor($number);
        $words = self::numberToWords($cedis) . " Ghana Cedis";
        if ($pesewas > 0) {
            $words .= " and " . self::numberToWords($pesewas) . " Pesewas";
        }
        return $words;
    }
    private static function numberToWords($num) {
        // 标准数字转英文单词逻辑
        // 可参考现有库如 NumberToWords
        return (new NumberToWords\NumberToWords())->transform($num, 'en');
    }
}

完整使用示例

// 用户输入
$userInput = "eGH¢ 250.75";
// 规范化处理
$ghsAmount = CurrencyDetector::normalizeToGHS($userInput, 1.02);
echo "实际GHS金额: " . GhanaCediFormatter::formatGHS($ghsAmount);
// 输出: GH¢ 245.83
// 显示原始eGHS
$detected = CurrencyDetector::detectAndConvert($userInput);
echo "原始eGHS: " . GhanaCediFormatter::formatEGHS($detected['amount']);
// 输出: eGH¢ 250.75