PHP项目数字兰特与eZAR

wen PHP项目 2026-07-17 155

本文目录导读：

PHP项目数字兰特与eZAR

什么是数字兰特和eZAR？
PHP集成方案
注意事项

我来帮你了解PHP项目中有关数字兰特（ZAR）和电子兰特（eZAR）的集成方案。

什么是数字兰特和eZAR？

数字兰特 (Digital ZAR)：南非兰特的数字货币形式
eZAR：南非储备银行（SARB）发行的电子兰特，是一种央行数字货币（CBDC）

PHP集成方案

基础配置类

<?php
class ZARManager {
    private $apiEndpoint;
    private $apiKey;
    private $environment; // 'sandbox' 或 'production'
    public function __construct($environment = 'sandbox') {
        $this->environment = $environment;
        $this->apiEndpoint = $environment === 'sandbox' 
            ? 'https://sandbox-api.sarb.co.za/v1'
            : 'https://api.sarb.co.za/v1';
    }
    public function convertToDigitalZAR($amount) {
        // 转换传统兰特到数字兰特
        return [
            'amount' => $amount,
            'digital_zar' => $this->formatDigitalCurrency($amount),
            'conversion_rate' => 1.0, // 1:1 兑换率
            'timestamp' => time()
        ];
    }
    public function validateDigitalTransaction($transactionId) {
        // 验证数字兰特交易
        $ch = curl_init($this->apiEndpoint . '/transactions/' . $transactionId);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => [
                'Authorization: Bearer ' . $this->apiKey,
                'Content-Type: application/json'
            ]
        ]);
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        return [
            'success' => $httpCode === 200,
            'data' => json_decode($response, true)
        ];
    }
    private function formatDigitalCurrency($amount) {
        return number_format($amount, 2, '.', '') . ' eZAR';
    }
}

钱包管理类

<?php
class DigitalWallet {
    private $pdo;
    private $zarManager;
    public function __construct(PDO $pdo) {
        $this->pdo = $pdo;
        $this->zarManager = new ZARManager();
    }
    public function createWallet($userId) {
        $walletAddress = $this->generateWalletAddress();
        $stmt = $this->pdo->prepare(
            "INSERT INTO digital_wallets (user_id, wallet_address, balance_zar, balance_ezar, created_at) 
             VALUES (?, ?, 0.00, 0.00, NOW())"
        );
        return $stmt->execute([$userId, $walletAddress]);
    }
    public function getBalance($userId) {
        $stmt = $this->pdo->prepare(
            "SELECT balance_zar, balance_ezar FROM digital_wallets WHERE user_id = ?"
        );
        $stmt->execute([$userId]);
        return $stmt->fetch(PDO::FETCH_ASSOC);
    }
    public function transferToDigital($userId, $amount) {
        try {
            $this->pdo->beginTransaction();
            // 检查传统兰特余额
            $balance = $this->getBalance($userId);
            if ($balance['balance_zar'] < $amount) {
                throw new Exception("余额不足");
            }
            // 执行转换
            $digitalZar = $this->zarManager->convertToDigitalZAR($amount);
            // 更新余额
            $stmt = $this->pdo->prepare(
                "UPDATE digital_wallets 
                 SET balance_zar = balance_zar - ?, 
                     balance_ezar = balance_ezar + ? 
                 WHERE user_id = ?"
            );
            $stmt->execute([$amount, $amount, $userId]);
            // 记录交易
            $this->logTransaction($userId, 'ZAR_TO_eZAR', $amount, $digitalZar['digital_zar']);
            $this->pdo->commit();
            return true;
        } catch (Exception $e) {
            $this->pdo->rollBack();
            throw $e;
        }
    }
    private function generateWalletAddress() {
        return 'eZAR_' . bin2hex(random_bytes(16));
    }
    private function logTransaction($userId, $type, $amount, $digitalAmount) {
        $stmt = $this->pdo->prepare(
            "INSERT INTO transactions (user_id, transaction_type, amount_zar, amount_ezar, status, created_at) 
             VALUES (?, ?, ?, ?, 'completed', NOW())"
        );
        $stmt->execute([$userId, $type, $amount, $digitalAmount]);
    }
}

API集成类

<?php
class eZAR_API {
    private $clientId;
    private $clientSecret;
    private $baseUrl;
    public function __construct($clientId, $clientSecret) {
        $this->clientId = $clientId;
        $this->clientSecret = $clientSecret;
        $this->baseUrl = 'https://api.ezar.co.za/v2';
    }
    public function makePayment($fromAddress, $toAddress, $amount, $memo = '') {
        $token = $this->getAccessToken();
        $payload = [
            'from' => $fromAddress,
            'to' => $toAddress,
            'amount' => $amount,
            'currency' => 'eZAR',
            'memo' => $memo,
            'timestamp' => time(),
            'signature' => $this->generateSignature($fromAddress, $toAddress, $amount)
        ];
        $ch = curl_init($this->baseUrl . '/payments');
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => json_encode($payload),
            CURLOPT_HTTPHEADER => [
                'Authorization: Bearer ' . $token,
                'Content-Type: application/json'
            ]
        ]);
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        return [
            'success' => $httpCode === 201,
            'transaction_id' => json_decode($response, true)['id'] ?? null,
            'status' => $httpCode
        ];
    }
    private function getAccessToken() {
        // OAuth2 认证
        $ch = curl_init($this->baseUrl . '/oauth/token');
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => http_build_query([
                'grant_type' => 'client_credentials',
                'client_id' => $this->clientId,
                'client_secret' => $this->clientSecret
            ])
        ]);
        $response = json_decode(curl_exec($ch), true);
        curl_close($ch);
        return $response['access_token'] ?? null;
    }
    private function generateSignature($from, $to, $amount) {
        // 使用HMAC-SHA256签名
        $data = $from . $to . $amount . time();
        return hash_hmac('sha256', $data, $this->clientSecret);
    }
}

使用示例

<?php
// 初始化
$pdo = new PDO('mysql:host=localhost;dbname=ezar_system', 'user', 'password');
$wallet = new DigitalWallet($pdo);
// 创建钱包
$wallet->createWallet(123);
// 获取余额
$balance = $wallet->getBalance(123);
echo "传统兰特: R" . $balance['balance_zar'] . "\n";
echo "数字兰特: " . $balance['balance_ezar'] . " eZAR\n";
// 转换货币
try {
    $wallet->transferToDigital(123, 1000); // 转换R1000到eZAR
    echo "转换成功！\n";
} catch (Exception $e) {
    echo "转换失败: " . $e->getMessage() . "\n";
}
// API支付
$api = new eZAR_API('your_client_id', 'your_client_secret');
$result = $api->makePayment(
    'eZAR_abc123...',
    'eZAR_xyz789...',
    500.00,
    '商品付款'
);