PHP与以太坊钱包交易,实现与指南

投稿 2026-02-11 21:21 点击数： 4

随着区块链技术的飞速发展,以太坊作为全球第二大加密货币平台，其智能合约和代币交易功能吸引了大量开发者和企业，对于许多基于PHP构建的Web应用而言，集成以太坊钱包交易功能成为了一项常见需求，本文将详细介绍如何使用PHP进行以太坊钱包交易，包括环境准备、核心库选择、交易流程以及注意事项。

为什么选择PHP进行以太坊交易

PHP作为一种成熟、广泛使用的服务器端脚本语言，拥有庞大的开发者社区和丰富的框架生态（如Laravel、Symfony等），将PHP与以太坊结合，可以方便地为现有的Web应用添加区块链交互能力，

实现用户以太坊钱包地址的绑定与管理。
发送ETH或ERC-20代币给用户。
接收用户支付的ETH或ERC-20代币。
与智能合约进行交互（调用函数、读取数据等）。

准备工作：环境与依赖

在开始之前,你需要确保以下环境和工具已准备就绪：

PHP环境：建议使用PHP 7.4或更高版本，以确保兼容性和性能。
以太坊节点：PHP应用需要与以太坊网络进行通信，你可以选择：
- Infura：提供可靠的远程节点服务，无需自行搭建，适合开发和大多数生产场景，你需要注册Infura并获取一个项目ID。
- Alchemy：与Infura类似，提供高质量的以太坊节点服务。
- 本地节点：使用Geth或Parity等客户端搭建本地私有测试网或连接到主网，这种方式更灵活，但对服务器资源要求较高。
钱包：你需要一个以太坊钱包来发送交易，这可以是：
- 硬件钱包（如Ledger, Trezor）：安全性最高。
- 软件钱包（如MetaMask）：方便开发测试，但需妥善保管私钥。
- 由PHP管理的钱包：通过私钥或助记词在服务器端生成和管理钱包，安全性极高，务必做好私钥的保密和备份，防止泄露！
PHP以太坊库：选择一个合适的PHP库来简化以太坊交互，目前最流行和推荐的是 web3php（原 ethereum-php），它是一个功能强大的PHP库，支持JSON-RPC协议，可以与以太坊节点交互，包括账户管理、交易发送、智能合约交互等。

安装与配置Web3php

通过Composer可以轻松安装web3php：

composer require sc0vu/web3php

安装完成后,你可以在PHP代码中引入它：

require 'vendor/autoload.php';
use Web3\Web3;
use Web3\Contract;
use Web3\Providers\HttpProvider;
use Web3\RequestManagers\HttpManager;

核心步骤：发送以太坊（ETH）交易

下面我们以通过PHP发送一笔ETH交易为例,说明核心步骤。

连接到以太坊节点

$nodeUrl = 'https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID'; // 替换为你的Infura URL或其他节点URL
$web3 = new Web3(new HttpProvider(new HttpManager($nodeUrl)));
// 或者连接到本地节点
// $web3 = new Web3(new HttpProvider(new HttpManager('http://localhost:8545')));

准备交易参数

发送ETH交易需要以下关键信息：

from：发送方地址（钱包地址）。
to：接收方地址。
value：发送的ETH数量，单位是wei（1 ETH = 10^18 wei）。
gas：交易预计消耗的gas上限。
gasPrice：gas价格，单位是wei。
nonce：发送方账户的nonce值，用于防止交易重放，必须递增。

$fromAddress = '0xSenderAddress...'; // 发送方地址
$toAddress = '0xReceiverAddress...'; // 接收方地址
$privateKey = 'YOUR_SENDER_PRIVATE_KEY'; // 发送方私钥，**极度敏感，切勿泄露！**
$value = '1000000000000000000'; // 1 ETH in wei
$gas = '21000'; // 转账ETH的典型gas消耗
// 获取当前gas price
$web3->eth->gasPrice(function ($err, $gasPrice) use ($web3, $fromAddress, $toAddress, $value, $gas, $privateKey) {
    if ($err !== null) {
        echo "Error getting gas price: " . $err->getMessage();
        return;
    }
    $gasPrice = $gasPrice->toString();
    // 获取nonce
    $web3->eth->getTransactionCount($fromAddress, 'latest', function ($err, $nonce) use ($web3, $fromAddress, $toAddress, $value, $gas, $gasPrice, $privateKey) {
        if ($err !== null) {
            echo "Error getting nonce: " . $err->getMessage();
            return;
        }
        $nonce = $nonce->toString();
        // 构建交易数组
        $transaction = [
            'from' => $fromAddress,
            'to' => $toAddress,
            'value' => $value,
            'gas' => $gas,
            'gasPrice' => $gasPrice,
            'nonce' => $nonce,
        ];
        // 签名并发送交易
        $web3->eth->sendTransaction($transaction, $privateKey, function ($err, $txHash) {
            if ($err !== null) {
                echo "Error sending transaction: " . $err->getMessage();
                return;
            }
            echo "Transaction sent! Hash: " . $txHash . "\n";
        });
    });
});

签名与发送交易

在上面的代码中,我们使用了$web3->eth->sendTransaction($transaction, $privateKey, $callback)方法，这个方法会使用提供的私钥对交易进行签名，然后发送到以太坊网络。

检查交易状态

发送交易后,你可以通过交易哈希（txHash）在以太坊浏览器（如Etherscan）上查看交易状态，也可以使用web3php的eth_getTransactionReceipt方法来查询交易收据，确认交易是否被矿工打包。

$txHash = '0xYourTransactionHash...';
$web3->eth->getTransactionReceipt($txHash, function ($err, $receipt) {
    if ($err !== null) {
        echo "Error getting receipt: " . $err->getMessage();
        return;
    }
    if ($receipt) {
        echo "Transaction receipt: " . json_encode($receipt, JSON_PRETTY_PRINT) . "\n";
        if ($receipt->status === '0x1') {
            echo "Transaction successful!\n";
        } else {
            echo "Transaction failed.\n";
        }
    } else {
        echo "Transaction not yet mined.\n";
    }
});

发送ERC-20代币交易

发送ERC-20代币比发送ETH稍微复杂，因为它需要调用智能合约，web3php的Contract功能可以帮助我们完成。

获取ERC-20代币合约ABI：ABI是应用程序二进制接口，定义了合约的函数和事件，你可以在Etherscan上找到代币合约的ABI。

实例化合约：

$tokenContractAddress = '0xTokenContractAddress...'; // ERC-20代币合约地址
$tokenAbi = '[...你的ERC-20代币合约ABI...]'; // JSON格式的ABI字符串
$contract = new Contract($web3->provider, $tokenAbi);
$contract->at($tokenContractAddress);

调用transfer函数： ERC-20代币的transfer函数通常需要两个参数：to（接收地址）和value（转账数量，单位是代币的最小单位，通常为18位小数）。

$recipientAddress = '0xRecipientAddress...';
$tokenAmount = '500000000000000000000'; // 例如500代币，假设18位小数
// 构建调用数据
$transferData = $contract->transfer($recipientAddress, $tokenAmount)->encodeParameters();
// 发送交易（与ETH交易类似，但目标是代币合约）
$transaction = [
    'from' => $fromAddress,
    'to' => $tokenContractAddress,
    'value' => '0x0', // 代币转账，value为0
    'gas' => '200000', // ERC-20 transfer通常需要更多gas
    'gasPrice' => $gasPrice, // 同样需要获取gasPrice
    'nonce' => $