PHP实现以太坊代币转账,从零开始的完整指南

php -v

Composer依赖管理

Web3.php库通过Composer管理依赖，需先安装Composer，访问Composer官网下载对应系统的安装包，或通过以下命令安装（Linux/macOS）：

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

以太坊节点或Infura服务

代币转账需要与以太坊网络交互,可通过以下两种方式获取节点连接：

• 本地节点：运行Geth或OpenEthereum客户端，同步以太坊主网或测试网数据（需较高硬件配置）。
• Infura服务：Infura 提供云端节点服务，注册后可免费获取测试网（如Goerli）和主网节点URL，适合开发阶段使用。

以太坊钱包与私钥

准备一个用于转账的以太坊钱包（如MetaMask），导出转账账户的私钥（⚠️注意：私钥需妥善保管，切勿泄露或提交到代码仓库）。

核心依赖：安装Web3.php库

Web3.php是以太坊PHP生态的核心库，提供了与以太坊节点交互的RPC接口，包括账户管理、合约调用、交易签名等功能，通过Composer安装：

composer require sc0vu/web3.php

安装完成后,在PHP代码中引入自动加载文件：

require 'vendor/autoload.php';
use Web3\Web3;
use Web3\Contract;
use Web3\Utils;

代币转账实现步骤

以太坊代币（ERC-20）的转账本质是调用智能合约的transfer方法，需完成以下步骤：

连接以太坊节点

使用Web3.php创建Web3实例，连接到以太坊节点（以Infura Goerli测试网为例）：

$nodeUrl = 'https://goerli.infura.io/v3/YOUR_INFURA_PROJECT_ID'; // 替换为你的Infura项目ID
$web3 = new Web3($nodeUrl);
// 检查连接是否成功
$web3->eth->getBlockNumber(function ($err, $blockNumber) {
    if ($err) {
        echo '连接失败: ' . $err->getMessage();
        return;
    }
    echo '当前区块号: ' . $blockNumber;
});

加载账户私钥

使用Web3.php的personal模块解锁账户（需节点开启personal API，或使用MetaMask的签名功能）：

$privateKey = 'YOUR_ACCOUNT_PRIVATE_KEY'; // 替换为你的私钥（不带0x前缀）
$account = $web3->eth->accounts->at(0); // 若节点已解锁，可通过索引获取账户

获取代币合约ABI与地址

ERC-20代币的transfer方法需通过智能合约调用，需提前获取代币的合约ABI（Application Binary Interface，JSON格式）和合约地址，Goerli测试网上的USDT合约地址为0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619，ABI可从Etherscan获取。

构建代币转账交易

通过Contract实例调用代币的transfer方法，需指定接收者地址和转账金额（ERC-20代币通常使用uint256，精度为18位小数，如转账100 USDT需传入100 * 10^18）：

// 代币合约地址与ABI
$tokenAddress = '0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619';
$tokenAbi = '[{"constant":false,"inputs":[{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transfer","outputs":[{"name":"success","type":"bool"}],"type":"function"}]';
// 创建合约实例
$contract = new Contract($web3->provider, $tokenAbi);
// 接收者地址与转账金额（单位：wei，18位小数）
$toAddress = '0xReceiverAddressHere'; // 替换为接收者地址
$amount = '100000000000000000000';    // 100 USDT（100 * 10^18）
// 构建transfer调用数据
$transferData = $contract->transfer($toAddress, $amount)->encodeABI();
// 获取当前nonce（防止交易重放）
$web3->eth->getTransactionCount($account->address, 'pending', function ($err, $nonce) use ($web3, $account, $tokenAddress, $transferData) {
    if ($err) {
        echo '获取Nonce失败: ' . $err->getMessage();
        return;
    }
    // 构建交易参数
    $transaction = [
        'from' => $account->address,
        'to' => $tokenAddress,
        'value' => '0x0', // 代币转账value为0，通过合约方法传递金额
        'gas' => '0x5208', // Gas限制（21000，可根据实际情况调整）
        'gasPrice' => '0x9184e72a000', // Gas价格（根据网络拥堵情况调整，此处为10 Gwei）
        'nonce' => '0x' . dechex($nonce),
        'data' => $transferData,
    ];
    // 签名并发送交易
    $web3->eth->sendTransaction($transaction, $account->privateKey, function ($err, $txHash) {
        if ($err) {
            echo '交易发送失败: ' . $err->getMessage();
            return;
        }
        echo '交易哈希: ' . $txHash . PHP_EOL;
        echo '请等待区块确认，可在Etherscan查看交易状态。';
    });
});

处理交易结果

交易发送后,会返回交易哈希（Transaction Hash），可通过Etherscan或节点API查询交易状态（是否成功、是否被矿工打包等），若交易失败，需检查Gas是否充足、合约地址与ABI是否正确、接收者地址格式是否合规等。

完整代码示例

以下是整合上述步骤的完整PHP代码（需替换实际参数）：

<?php
require 'vendor/autoload.php';
use Web3\Web3;
use Web3\Contract;
use Web3\Utils;
// 配置参数
$nodeUrl = 'https://goerli.infura.io/v3/YOUR_INFURA_PROJECT_ID';
$privateKey = 'YOUR_ACCOUNT_PRIVATE_KEY';
$tokenAddress = '0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619';
$toAddress = '0xReceiverAddressHere';
$amount = '100000000000000000000'; // 100 USDT
// 代币ABI（简化版）
$tokenAbi = '[{"constant":false,"inputs":[{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transfer","outputs":[{"name":"success","type":"bool"}],"type":"function"}]';
try {
    // 1. 连接节点
    $web3 = new Web3($nodeUrl);
    // 2. 获取账户地址
    $account = $web3->eth->accounts->at(0);
    echo '发送方地址: ' . $account->address . PHP_EOL;
    // 3. 获取nonce
    $web3->eth->get