PHP项目数字瓦努阿图瓦图与eVUV

本文目录导读：

1. 核心概念：VUV vs eVUV
2. PHP 实现要点
3. 特殊注意事项（项目关键）
4. 简单的 API 设计示例
5. 总结建议

针对你提到的 “PHP 项目 数字瓦努阿图瓦图与 eVUV” 这个需求，核心在于理解 VUV（瓦努阿图瓦图，法币）与 eVUV（电子瓦图，数字代币）之间的关系，以及如何在 PHP 中实现相关的处理逻辑。

以下是一个完整的分析与实现指南。

核心概念：VUV vs eVUV

• VUV (Vatu)：瓦努阿图法定货币，通常以小数点后 0 位（整数）或 2 位（分）表示。
• eVUV (Electronic Vatu)：一种数字稳定币，1 eVUV = 1 VUV。
• 关系：eVUV 是 VUV 在区块链/数字钱包上的等价表示。

PHP 实现要点

1 数据精度处理

由于涉及货币,绝对不要使用 float 或 double，必须使用 PHP 的 BCMath 扩展 或 GMP 处理高精度计算。

确认 BCMath 扩展已启用：

php -m | grep bcmath

如果没有,安装：

sudo apt-get install php-bcmath  # Debian/Ubuntu
# 或
docker-php-ext-install bcmath    # Docker

2 数据库设计 (MySQL/PostgreSQL)

建议使用 DECIMAL 类型，精度设为 20, 8（通常足够，甚至到 18 位小数适应链上单位，如 Wei/Satoshi）。

CREATE TABLE wallets (
    user_id INT PRIMARY KEY,
    -- 余额以 VUV 的最小单位（分或更小的 Satoshi 级别）存储
    balance_vuv DECIMAL(20, 8) DEFAULT 0.00000000,
    balance_evuv DECIMAL(20, 8) DEFAULT 0.00000000,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

3 核心业务逻辑类 (PHP)

<?php
class VUVManager
{
    // 精确分位数：1 VUV = 10^8 最小单位 (类似 USDC)
    public const SCALE = 8;
    /**
     * 转换 VUV 到 eVUV (1:1 固定汇率，简化版)
     * @param string $amountVUV  VUV 金额 (字符串，避免浮点)
     * @return string eVUV 金额
     */
    public function convertVUVToEVUV(string $amountVUV): string
    {
        // 在此加入汇率逻辑，目前简单返回
        return bcadd($amountVUV, '0', self::SCALE);
    }
    /**
     * 转账 eVUV
     * @param int $fromUserId
     * @param int $toUserId
     * @param string $amount 金额 (eVUV)
     * @return bool
     * @throws \Exception
     */
    public function transferEVUV(int $fromUserId, int $toUserId, string $amount): bool
    {
        // 1. 使用数据库事务
        $pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
        $pdo->beginTransaction();
        try {
            // 2. 检查余额 (使用悲观锁)
            $stmt = $pdo->prepare("SELECT balance_evuv FROM wallets WHERE user_id = ? FOR UPDATE");
            $stmt->execute([$fromUserId]);
            $row = $stmt->fetch();
            if (!$row) {
                throw new \Exception("发送方钱包不存在");
            }
            $balance = $row['balance_evuv'];
            if (bccomp($balance, $amount, self::SCALE) < 0) {
                throw new \Exception("余额不足");
            }
            // 3. 执行转账 (使用 BCMath)
            $newFromBalance = bcsub($balance, $amount, self::SCALE);
            $stmt = $pdo->prepare("UPDATE wallets SET balance_evuv = ? WHERE user_id = ?");
            $stmt->execute([$newFromBalance, $fromUserId]);
            // 接收方增加
            $stmt = $pdo->prepare("SELECT balance_evuv FROM wallets WHERE user_id = ? FOR UPDATE");
            $stmt->execute([$toUserId]);
            $toRow = $stmt->fetch();
            $newToBalance = bcadd($toRow['balance_evuv'], $amount, self::SCALE);
            $stmt = $pdo->prepare("UPDATE wallets SET balance_evuv = ? WHERE user_id = ?");
            $stmt->execute([$newToBalance, $toUserId]);
            // 4. 记录交易流水 (重要!)
            // INSERT INTO transactions (from, to, amount, type, timestamp) VALUES (...)
            $pdo->commit();
            return true;
        } catch (\Exception $e) {
            $pdo->rollBack();
            throw $e;
        }
    }
    /**
     * 安全格式化输出 (去掉多余尾随零)
     * @param string $amount
     * @return string
     */
    public function formatAmount(string $amount): string
    {
        // 去除尾随零，但保留至少两位小数 (VUV 习惯)
        $trimmed = rtrim(rtrim($amount, '0'), '.');
        // 如果小数点后不足两位，补零 ("100" -> "100.00")
        if (strpos($trimmed, '.') === false) {
            return $trimmed . '.00';
        }
        $parts = explode('.', $trimmed);
        if (strlen($parts[1]) < 2) {
            $parts[1] = str_pad($parts[1], 2, '0');
        }
        return implode('.', $parts);
    }
}
// 使用示例
$manager = new VUVManager();
try {
    $manager->transferEVUV(1, 2, '10.50000000');
    echo "转账成功";
} catch (\Exception $e) {
    echo "失败: " . $e->getMessage();
}

特殊注意事项（项目关键）

1 兑换比率

• 固定 1:1：如果只是 eVUV 官网兑换，直接 1:1 即可。
• 市场浮动：如果你在做一个第三方交易平台（类似币安），则需要对接 实时汇率 API（如 CoinGecko 的 VUV/eVUV 交易对）。convertVUVToEVUV 方法需要调用外部 API。

2 区块链交互（可选）

如果项目需要 与真实的 eVUV 区块链交互，PHP 不是最佳选择（Node.js/Go 更适合），但如果必须用 PHP：

• 使用 RPC（推荐，简单稳定） 用 file_get_contents 或 Guzzle 调用链上节点 RPC 接口（eth_call 或 vite_xxx）。

  // 调用链上合约的 balanceOf 方法
  $data = '0x70a0823100000000...'; // 编码后的参数
  $rpcPayload = [
      'jsonrpc' => '2.0',
      'method' => 'eth_call',
      'params' => [['to' => '合约地址', 'data' => $data], 'latest'],
      'id' => 1
  ];

• 使用 PHP 区块链库 web3.php (Ethereum) 或 kotlin/php-ethereum，注意 eVUV 如果基于自定义链，需要找到对应 PHP 的 SDK。

3 安全性

• SQL 注入：务必使用 Prepared Statements（如上面示例）。
• 整数溢出：使用 BCMath 处理字符串，PHP 的 int 类型在 64 位系统上最大值约 2e18，VUV 最大供应量远小于此，但 bccomp 更安全。
• 原子性：转账必须用数据库事务 + 行锁 (FOR UPDATE)。
• 双花防范：假设你的数据库是单点，用事务锁足够，如果分布式，需要引入 Redis 分布式锁。

简单的 API 设计示例

// routes/api.php (Laravel 风格)
Route::post('/transfer', function (Request $request) {
    $validator = Validator::make($request->all(), [
        'to' => 'required|integer',
        'amount' => 'required|regex:/^\d+(\.\d{1,8})?$/' // 最多8位小数
    ]);
    if ($validator->fails()) {
        return response()->json(['error' => $validator->errors()], 400);
    }
    $manager = new VUVManager();
    try {
        $manager->transferEVUV(Auth::id(), $request->to, $request->amount);
        return response()->json(['success' => true]);
    } catch (\Exception $e) {
        return response()->json(['error' => $e->getMessage()], 400);
    }
});

总结建议

如果你能提供更多关于你的项目信息（比如是否直接写智能合约、是否已有钱包系统），我可以给你更具体的代码结构建议。